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Preface 



Use this book as a reference manual; it contains all of the command formats, syntax 
rules, and operand and option descriptions for the XEDIT command and XEDIT 
subcommands and macros. For tutorial information on using the editor, refer to the 
VM/SP System Product Editor User's Guide. The User's Guide also contains 
information on using the System Product Interpreter, which processes programs 
written in the Restructured Extended Executor (REXX) language, for XEDIT 
macros. You should be familiar with the User's Guide before you attempt to use this 
reference book. This pubUcation has the following chapters: 

"Chapter 1 : Rules and Conventions" tells you how to enter the XEDIT command 
and its subcommands and macros. It lists the notation conventions used in this 
book, so that you can interpret the command format descriptions starting in Chapter 

2. 

"Chapter 2: The XEDIT Command" contains the format description, and operand 
and option list for the XEDIT command, which is used to invoke the editor. 

"Chapter 3: XEDIT Subcommands and Macros" describes the subcommands and 
macros available in the environment of the editor. Each subcommand and macro 
description contains usage notes and/or examples, summarizes the types of responses 
you might receive, and lists the error messages and return codes. 

"Chapter 4: XEDIT Prefix Subcommands and Macros" describes the prefix 
subcommands and macros, which are entered directly in an area called the prefix 
area of any line in a file. 

This book also has the following appendixes: 

"Appendix A: File Type Defaults" lists the special file types that are recognized by 
the editor and indicates the default settings that the editor suppUes for logical record 
length, logical tabs, truncation, and so on. 

"Appendix B: Effects of Selective Line Editing Subcommands" details the effects of 
SET SELECT, SET DISPLAY, SET SCOPE, and SET SHADOW on other XEDIT 
subcommands. 

"Appendix C: CMS Editor (EDIT) Migration Mode" explains how to edit a file in 
EDIT migration mode. 

"Appendix D: Migrating from EDIT to XEDIT" lists the EDIT subcommands and 
their XEDIT counterparts. 

"Appendix E: Optimizing Macros" describes how to improve the performance of 
macros and lists those XEDIT macros that have been optimized. 

"Appendix F: Using Double-Byte Character Sets" describes the special 
considerations for manipulating DBCS strings in the XEDIT environment. 

"Appendix G: XEDIT Virtual Screens and Windows" describes how virtual screens 
and windows are defined. 
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"Appendix H: A Summary of XEDIT Subcommands and Macros" lists all the 
XEDIT subcommands and macros, their abbreviations, and a brief description of 
functions. 
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Rules and Conventions 



Chapter 1. Rules and Conventions 



XEDIT subcommands and macros follow the same rules and conventions. For 
purposes of this discussion, "subcommand" refers to both XEDIT subcommands and 
XEDIT macros. 

The general format of XEDIT subcommands is: 



subcommand 
name 



operands. 



At least one blank must separate the subcommand name and the operands, unless 
the operand is a number or a special character. For example, NEXT8 and NEXT 8 
are equivalent. 

At least one blank must be used to separate each operand in the command line 
unless otherwise indicated. 

The maximum length of an XEDIT subcommand issued from an exec procedure or 
from an XEDIT macro is 256 characters. The maximmn length of an XEDIT 
subcommand issued from the XEDIT command line is 255 characters. 



Subcommand Name 



The subcommand name is an alphabetic symbol of one-to-eight characters. In 
general, the names are based on verbs that describe the function you want the editor 
to perform. For example, the ADD subcommand adds Hues to the file. 



Subcommand Operands 



The subcommand operands may be either keyword or positional or a combination of 
both. The operands specify the information on which the editor operates when it 
performs the subcommand function. The operands must be entered in the order in 
which they appear in the command format boxes. 

One of the most widely-used operands in XEDIT is the "target" operand, which 
provides various ways to identify a line to the editor. The concept of a target is 
described in the LOCATE subcommand in this book and in the VM/SP System 
Product Editor User's Guide. You should become famihar with targets before 
attempting to use XEDIT subcommands that require target operands. 



Character Set Usage 



XEDIT subcommands may be entered using a combination of characters from six 
different character sets. The contents of each of the character sets is shown in 
Table 1 on page 2. 
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Table 1 . Character Sets and Their Contents 


Character Set 


Names 


Symbols 


Separator 


Blank 




National 


Dollar Sign 
Pound Sign 
At Sign 


$ 
# 
@ 


Alphabetic 


Uppercase 
Lowercase 


A-Z 

a - z 


Numeric 


Numeric 


0-9 


Alphameric 


National 
Alphabetic 


A-Z 

a - z 




Numeric 


0-9 


Special 




All other characters 



Notation Conventions 



The notation used to define the command syntax in this book is: 

• Abbreviations 

Where an abbreviation of a subcommand name is permitted, the shortest 
acceptable version of the name is represented by uppercase letters. 
(However, the subcommands can be entered on the terminal in any 
combination of uppercase and lowercase letters.) For example, the 
subcommand 

DELete 

may be specified as DEL, DELE, DELET, or DELETE. 

Operands are represented in the same way. When an abbreviation is 
permitted, the shortest acceptable version of the operand is represented by 
uppercase letters in the subcommand format box. If no minimum 
abbreviation is shown, the entire word (represented by uppercase letters) 
must be entered. 

• The following symbols are used to define the subcommand format and should 
never be typed when the actual subcommand is entered. 



underscore 
braces 
brackets 
ellipsis 



{} 



Uppercase letters and the following symbols should be entered as specified in the 
format box. 

asterisk * 

comma , 

equal sign = 

parentheses ( ) 

period 

colon : 
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• Lowercase letters, words, and symbols that appear in the subcommand format 
box represent variables for which specific information must be substituted when 
the subcommand is entered. For example, "fnftfm" indicates that a file 
identifier such as "MYFILE SCRIPT Al" should be entered. 

• Brackets around a single operand mean the operand is optional. 
FILE [fn] 

The "/n" operand is optional. 

FILE fn 

The "/«" operand must be entered. 

• Choices are represented in the format boxes by stacking the operands or by 
separating the operands with a vertical bar (1). For example, 

A 

B or A|B|C 

C 

indicates that a choice is to be made between A, B, and C. 
Braces also indicate that a choice is to be made. For example, 



or {A|B|C} 



indicates that a choice is to be made between A, B, and C. 

• The use of brackets denotes choices, one of which may be selected. For 
example. 



or [A|B|C] 



indicates that you may enter A, B, or C, or you may omit the operand. 

• An underscored operand represents a default. If the operand is omitted, the 
editor automatically supplies the operand that is underlined. For example. 



If no operand is specified, B is assumed. 
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An ellipsis indicates that the preceding operand may be repeated successively. 
For example, 

A 

B ... 
C 



indicates that you must select A, B, or C one time and that you may specify one 
of the three more than once in succession, for example, 

ABC A 
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Chapter 2. The XEDIT Command 



Format 



Use the CMS command XEDIT to invoke the editor to create, modify, and 
manipulate CMS files on disk or in Shared File System (SFS) directories. Once the 
editor has been invoked, you may execute XEDIT subcommands and use the System 
Product Interpreter or EXEC 2 macro faciUty. 

You can return control to the CMS environment by entering the XEDIT 
subcommand FILE or QUIT. 




[fn [ft [fm]]] [(options... [)] ] 

Options; 

[ Width nn ] [ NOSCreen ] [ PROFile macroname ] 
[NOPROFil] [NOCLear] [NOMsg] 
LMEMber membername] LWINdow wname] 

LOCk 
NOLOCk 

Options Valid Only in Update Mode: 



Update 
NOUpdate 



Seq8 



Ctl fnl 
NOCtl 



NOSeqS. 

[Merge] [UNtil filetype] [incr nn] 
[SIDcode string] 



Operands 



fnft 



fm 



are the file name and the file type of the file to be edited. If they are not 
specified here, they must be provided in the LOAD subcommand as part of the 
profile. 

is the file mode of the file to be edited, indicating an accessed minidisk or SFS 
directory where the file resides. The editor determines the file mode of the 
edited file as follows: 

• Editing existing files. 

When the file mode is specified, that disk or directory and its extensions are 
searched. If the file mode is not specified or is specified as an asterisk (*), 
all accessed disks and/or directories are searched for the specified file. 

• Creating new files. 

If the file mode is not specified, the editor assumes a file mode of Al. 
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Options 



Width nn 

defines the amount of virtual storage used to contain one line of the file. If the 
value specified is too small, certain file lines may be truncated. 

If not specified here, WIDTH may be dellned in the LOAD subcommand as a 
part of the profile. If WIDTH is not specified in either the XEDIT command or 
the LOAD subcommand, the default is the larger of the following: 

• The logical record length (LRECL) of the file 

• The default logical record length associated with the file type. See Appendix 
A for a list of these defaults. 

NOSCreen 

forces a 3270 display terminal into line (typewriter) mode. 

PROFile macroname 

If the specified macro exists on one of the accessed disks or SFS directories, the 
editor executes it as the first subcommand. 

If the specified macro is not found on an accessed CMS disk or SFS directory, 
an error message is displayed. 

If this option is not specified but a macro with a macro name of PROFILE 
exists, the editor executes it. 

In all cases, the profile macro must have a file type of XEDIT. 

NOPROFil 

forces the editor not to execute the default PROFILE macro. 

NOCLear 

specifies that the screen is not cleared when the editor gets control. Instead, the 
screen is placed in a MORE. . . (waiting) status. Any messages remain on the 
screen until the CLEAR key is pressed. This option is useful when the XEDIT 
command is issued from a macro that displays messages. 

NOMsg 

enters a file with a default of SET MSGMODE OFF. 

MEMber membemame 

is the name of a member in the macro Ubrary specified in fn ft fm. If 
MEMBER is specified, ft must be MACLIB. When the MEMBER option is 
specified, XEDIT scans the specified MACLIB to find the member. If the 
member is found, XEDIT reads it into storage. If the member does hot exist in 
that hbrary, a new file is created with a file ID of 'membemame MEMBER fm'. 

WINdow wname 

is the name of the virtual screen and window that XEDIT will use to display the 
file being edited. 

Note: The window name must not contain invalid file name characters. Also, 
"CMS" can not be used as the window name. 

For more information on virtual screens and windows, see Appendix G in this 
book, 

LOCk 

causes the editor to lock the file to prevent other users from modifying the file 
while you are editing it. Only existing files in SFS directories can be locked; the 
LOCK option is ignored for files on minidisks. You must have write authority 
to the file to lock it; if you have only read authority a warning is displayed and 
the editing session continues without locking the file. LOCK is the default. 
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The type of lock XEDIT uses is an update session lock. The file will be locked 
only for the duration of your editing session. Other users will be able to read 
the file while it is locked, but only you will be able to write to it. 

NOLOCk 

indicates that you do not want the editor to try to lock the file. This option can 
be used to edit a file that another user has locked SHARE or UPDATE. If you 
specify NOLOCK, other users may change the file while you are editing it. The 
NOLOCK option is ignored for files on minidisks. 

You should only use this option if you are not going to make any changes to the 
file, or if you will save your changes under a different file identifier. Otherwise, 
any changes that you make will not include modifications made to the 
permanent copy of the file by other users during your editing session. 

The following options are meaningful only if XEDIT is to be used in update mode: 

Update 

The editor searches all accessed CMS minidisks and SFS directories for a file 
with a file name of fn and a file type of UPDATE. If the file exists, the editor 
applies the update statements before displaying the file to be edited. Each new 
modification made by the user is added to the existing UPDATE file. The 
original source file is not modified. 

If the file does not exist, the editor creates a new UPDATE file with a file mode 
of Al to contain modifications made by the user. 

NOUpdate 

specifies that the editor is to apply no update statements (even if UPDATE is 
specified in the LOAD subcommand in the profile). 

Sea8 

specifies that the entire sequence field (the last eight columns of each file Une) 
contains an eight-digit sequence number. The SEQ8 option automatically forces 
the UPDATE option. SEQ8 is the default value. 

NOSeqS 

specifies that the last eight columns of the file line contain a three-character label 
field, followed by a five-digit sequence number. 

The NOSEQS option forces the UPDATE option. 

Ctl/nl 

specifies that "fnl CNTRL" is an update control file that controls the 
application of multiple update files to the file to be edited. (See the CMS 
UPDATE command in the VMjSP CMS Command Reference for more 
information.) 

This option automatically forces the UPDATE and SEQ8 options. 

NOCtl 

specifies that the editor is not to use the control file (even if it is specified in the 
LOAD subcommand in the profile). 

Mei^e 

specifies that all the updates made through the control file and all the changes 
made while editing will be written into the file whose name is defined by the 
latest update level (that is, the most recently applied UPDATE file in a control 
file). This option forces the UPDATE option. 



Chapter!. The XEDIT Command 7 



The XEDIT Command 



Usage Notes 



VNmfiletype 

specifies the file type of the last update to be applied to the file. Changes are 
applied to the file being edited firom all file types in the control file, up to and 
including the file type specified in the UNTIL option. 

File types of update files listed in the control file or of update files Hsted in an 
auxiliary control file can be specified with the UNTIL option. AUX file types 
(AUXxxxxx) cannot be specified with the UNTIL option. 

The UNTIL option forces the UPDATE option. 

Incr nn 

When inserting new lines in an update file, the editor automatically computes 
the serialization; the INCR option forces a minimum increment between two 
adjacent lines. If this option is not specified, the minimum increment is one (1). 
This option forces the UPDATE option. 

SIDcode string 

specifies a string that the editor inserts in every Une of an update file, whether 
the update file is being created or is an existing file. The editor inserts the 
specified string in the first eight columns of the last 1 7 columns of the file line 
(lrecl-16 to lrecl-9). For example, if you have a file with fixed, eighty-character 
lines, the editor inserts the string in columns 64-71. If the string is less than 
eight characters, it is padded on the right with blanks. Any data in the eight 
columns is overlaid. 

This option forces the UPDATE option. 



1. In order to use XEDIT on files in SFS directories, the directories must be 
accessed and you must have read or write authority to the file. 

2. When the LOCK option is in effect, it is possible for the lock to be removed 
during your edit session if one of the following abnormal errors occurs: 

• file system server failure 

• network or APPC/VM failure on the last communication link with the file 
pool. 

Note: If a CMS abend occurs, the update session lock obtained by XEDIT will 
not be deleted. 

3. For the PROFILE, CTL, SIDCODE, INCR, UNTIL, MEMBER, and WIDTH 
options, the operand must be specified; otherwise, the next option will be 
interpreted as its operand. For example, in the "PROFILE macroname" option, 
"macroname" must be specified; if it is not, the next option will be interpreted as 
the operand "macroname." 

4. Once the XEDIT command has been executed, the XEDIT subcommand can be 
used to edit and display multiple files simultaneously (see the XEDIT 
subcommand). 

5. You can also call the editor recursively (using "CMS XEDIT. . .," for example). 
This abiUty is particularly useful when appUcations are developed using the 
editor and its macro facilities to interface with the user, for example, HELP. 

6. The editor is kept in virtual storage as part of the CMS nucleus shared segment; 
the CMS user area is unused. As a result, assuming a large enough virtual 
machine, any CMS or CP command may be issued directly from the editor 
environment itself (if a SET IMPCMSCP subcommand is in effect). 
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When you call CMS XEDIT recursively, a new ring of files is begun that is 
independent of any previous ring(s). 

7. When the PROFILE macro is invoked by an XEDIT command, everything 
following the command name XEDIT is tokenized (truncated to eight 
characters), and then assigned to the argument string that is passed to the 
PROFILE macro. 

The editor does not examine any parameters that follow a closing right 
parenthesis on the XEDIT command. 

8. When you issue an XEDIT command for a variable-format file, traihng blanks 
are removed when the file is filed (or saved). 

9. Comment control records are deleted from an update file whenever an update 
file is appHed to the original source file during an editing session, and a FILE or 
SAVE subcommand is issued. 

10. Many languages have more characters than can be displayed using one-byte 
codes (KANJI, for example). A Double-Byte Character Set (DBCS) is used to 
represent those characters. The double-byte characters can appear in a sentence 
with characters from other languages that are displayed in 1-byte codes. Files 
containing double-byte characters are handled differently than files that only 
contain 1-byte characters. 

11. The MEMBER option and the NOUPDATE option have no effect when 
preceded by an option that automatically forces update processing. Likewise, 
options that usually force update processing are ignored when preceded by the 
MEMBER option or the NOUPDATE option. 

12. If full-screen CMS is set ON before XEDIT writes to the screen, XEDIT will 
issue the command SHOW WINDOW CMSOUT followed by SHOW 
WINDOW XEDIT or a SHOW for the particular window that has been set up 
to display the file. 



When editing a file that resides in an SFS directory, if you have only read authority 
to the file and you do not specify the NOLOCK option, you will receive the 
message: 

1299W Warning: not authorized to lock fn ft fm 

The editing session will continue but the file will not be locked. 

The following messages are displayed only if you are using XEDIT in update mode: 



1781 Updating fn ft fm 
Applying fn ft fm 



180W Missing PTF file /n ft fm 



Chapter 2. The XEDIT Command 9 



The XEDrr Command 



Messages 



002E File fn ft fm not found [RC = 28] 

003E Invalid option: option [RC=24] 

024E File XEDTEMP CMSUTl Al already exists [RC=28] 

029E Invalid parameter parameter in the option option field [RC = 24] 

048E Invalid mode mode [RC = 24] 

054E Incomplete fileid specified [RC = 24] 

062E Invalid character in fileid fn ft fm [RC = 20] 

065E option option specified twice [RC=24] 

066E option! and option2 are conflicting options [RC = 24] 

069E Filemode mode not accessed [RC = 36] 

070E Invalid parameter parameter [RC = 24] 

104S Error nn reading file fn ft fm firom disk [RC = 3 1 , 55, or 100] 

109S Virtual storage capacity exceeded [RC = 104] 

132S Filefnftfm too large [RC = 88] 

229E Unsupported OS dataset, error nn [RC = 80, 8 1 , 82, or 83] 

500E Unable to unpack file fn ft fm [RC = 88] 

508E LOAD must be the first subcommand in the profile [RC = 3] 

554E Not enough virtual storage available [RC = 104] 

5711 Creating new file: 

622E Insufficient free storage for {MSGLINE|PFkey/PAkey|synonyms} 

91 5E Maximum number of windows already defined [RC = 13] 

927E The virtual screen must contain at least 5 Unes and 20 colunms [RC=24] 

928E Command is not valid for virtual screen CMS [RC = 12] 

1 1 38E File sharing conflict for file fn ft fm [RC = 70] 

1214W File/«/if/m already locked SHARE 

1215E Filefnftfm is locked {SHARE|UPDATE1EXCLUSIVE} by another user 

[RC = 70] 

1 262S Error nn opening file fn ft fm [RC = 3 1 , 55, 70, 76, 99, or 1 00] 

1299W Warning: Not authorized to lock file fn ft fm 

1300E Error nn {locking|unlocking} file fn ft {fm\dirname} [RC = 55, 70, 76, 99, or 

100] 



Messages with Member Option 

007E Filefnftfm is not fixed, 80-character records [RC = 32] 

033E File fn ft fm is not a library [RC = 32] 

039E No entries in library fn ft fm [RC = 32] 

167S Previous MACLIB function not finished [RC = 88] 

622E Insufficient free storage for reading map [RC = 104] 

Messages with Update Options 

007E Filefnftfm is not fixed, 80-character records [RC = 32] 

007E Filefnftfm does not have a logical record length greater than or equal to 

80[RC = 32] 
007E Filefnftfm does not have the same format and record length SLsfnftfm 

[RC = 32] 
007E Filefnftfm is not fixed record format [RC = 32] 
104S Error nn reading Glefnftfm from disk [RC = 31, 32, or 55] 

174W Sequence error introduced in output file: seqnol to seqno2 [RC = 32] 

1781 Applying /n/r/m 

179E Missing or invalid MACS card in control filefnftfm 

180W Missing PTF filefnftfm 
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The XEDIT Command 



Return Codes 



183E Invalid {CONTROL| AUX} file control card [RC = 32] 

184W ./ S not first card in update file-ignored [RC = 32] 

185W Non numeric character in sequence field seqno [RC = 32] 

186W Sequence number [seqnol] not found [RC = 32] 

207W Invalid update file control card [RC = 32] 

2 low Input file sequence error: seqnol to seqno2 [RC = 32] 

570W Update ft specified in the UNTIL option field not found 

597E Unable to merge updates containing ./S cards [RC = 32] 

1262S Error nn opening mefnftfm [RC = 31, 55, 70, 76, 99, or 100] 



Normal 

3 LOAD must be the first subcommand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 

subcommand has been issued in a macro called from the last file in the ring 

12 Command is not valid for virtual screen 

13 Maximum number of windows already defined 

20 Invalid character in file name or file type 

24 Invalid parameters or options 

28 Source file not found (UPDATE MODE), or library not found (MEMBER 

option), or specified PROFILE macro does not exist, or file XEDTEMP 

CMSUTl already exists 

31 A rollback occurred 

32 Error during updating process, or file is not a library, or library has no entries, 
or file is not fixed, 80 char, records 

36 Corresponding minidisk or directory not accessed 
55 APPC/VM communications error 
70 File sharing conflict 
76 Connection error 

80 An I/O error occurred while an OS data set or DOS file was being read or an 
OS or DOS disk was detached without being released. 

81 The file is an OS read-password-protected data set or a DOS file with the input 
security indicator on. 

82 The OS data set or DOS file is not BPAM, BSAM, or QSAM. 

83 The OS data set or DOS file has more than 16 user labels or data extents. 

88 File is too large and does not fit into storage, or previous Maclib function was 
not finished 

99 A required system resource is not available 

100 Error reading the file into storage 
104 Insufficient storage available 
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The XEDIT Command 
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XEDIT Subcommands and Macros 



Chapter 3. XEDIT Subcommands and Macros 

This chapter describes the formats and operands of the XEDIT subcommands and 
macros. XEDIT subcommands and macros are valid only in the environment of the 
editor, which is invoked with the CMS command XEDIT, described in "Chapter 2: 
The XEDIT Command." 

The editor has two modes of operation: edit mode and input mode. Whenever the 
XEDIT command is entered, edit mode is entered; when the INPUT or REPLACE 
subcommands are issued with no operands, or when the POWERINP subcommand 
is issued, input mode is entered. 

For tutorial information on how to use the editor, refer to the VMfSP System 
Product Editor User's Guide. 

The XEDIT subcommands and macros are hsted in alphabetical order for easy 
reference. Each subcommand and macro description includes the format and 
description of operands and, where applicable, usage notes, notes for macro writers, 
responses, error messages and return codes, and examples. 

The following cormnands and subcommands exist in the CP, CMS, and XEDIT 
environments: 

CP 

QUERY 

SET. 

The following commands and subcommands exist in the CMS and XEDIT 
environments: 

HELP 
LOAD 
SORT 
XEDIT. 

The following command and subcommand exists in the CP and XEDIT 
environments: 

RESET. 
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ADD 



ADD 



Format 



Use the ADD subcommand to insert blank lines immediately after the current line. 



Add 



[n\l] 



Operand 



Usage Notes 



Responses 



Messages 



Return Codes 



is the number of blank hues you want to add. If you omit n, one hne is added. 



1. You can enter data in the newly-added lines at any time during the editing 
session. These blank lines remain in the file after it is saved or filed. 

2. If the current line is the End of File line, the lines are added preceding this line. 



If SET IMAGE ON is in effect, the cursor moves to the first tab column of the first 
Hne that was added. Otherwise, it is placed in column 1 . 

By default, the prefix areas associated with the added Hues are highhghted. For 
more information, refer to SET COLOR PENDING. 

Each Hne that is added is prefiUed with the current mask (see SET MASK). 

The Hne pointer remains unchanged. 



520E InvaHd operand: operand [RC = 5] 

529E Subcommand is only valid in {display|editing} mode [RC = 3] 

543E InvaHd number: number [RC = 5] 

557S No more storage to insert Hues [RC = 4] 



Normal 

3 Terminal is not a display 

4 Insufficient storage to add lines 

5 Invalid operand or number 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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ADD 



Examples 



Figure 1 is a before-and-after example of the ADD subcommand. 



ANIMALS FACTS Al V 80 Trunc=80 Size=28 Line=18 Col=l A1t=0 

===== A LIZARD OF CENTRAL AMERICA CALLED THE BASILISK CAN RUN 

===== ACROSS WATER. 

===== OCTOPI HAVE LARGE BRAINS AND SHOW CONSIDERABLE CAPACITY FOR 

===== LEARNING. 

===== THE ARMADILLO IS THE ONLY ARMORED MAMMAL. 

===== THE LION ROARS TO ANNOUNCE POSSESSION OF A PROPERTY. 

===== THE KILLER WHALE EATS DOLPHINS, PORPOISES, SEALS, PENGUINS, AND 

===== SQUID. 

===== THE BOOKLOUSE CAN BE FOUND IN OLD BOOKS. IT FEEDS ON THE GLUE OF THE 

===== BINDINGS AND ON MOLDS THAT GROW ON OLD PAPER. 

|...+....l....+....2....+....3....+....4....+....5....+....6...,+....7.. 
===== ALTHOUGH PORCUPINE FISHES BLOW THEMSELVES UP AND ERECT THEIR SPINES, 
===== THEY ARE SOMETIMES EATEN BY SHARKS. NO ONE KNOWS WHAT EFFECT THIS 
===== HAS ON THE SHARKS. 

===== A FISH CALLED THE NORTHERN SEA ROBIN MAKES NOISES LIKE A WET 
===== FINGER DRAWN ACROSS AN INFLATED BALLOON. 

===== STINGAREES. FISH FOUND IN AUSTRALIA. CAN WEIGH UP TO 800 POUNDS 
===== AND HAVE THE MOST POTENT VENOM OF ALL FISH. 

===== OSTRICHES CAN KICK LIKE A MULE, IMITATE A LION'S ROAR, AND HISS LIKE 
===== A SNAKE. 
====> add 5 

X E D I T 1 File 



ANIMALS FACTS Al V 80 Trunc=80 Size=33 Line=18 Col=l Alt=l 

===== A LIZARD OF CENTRAL AMERICA CALLED THE BASILISK CAN RUN 

===== ACROSS WATER. 

===== OCTOPI HAVE LARGE BRAINS AND SHOW CONSIDERABLE CAPACITY FOR 

===== LEARNING. 

===== THE ARMADILLO IS THE ONLY ARMORED MAMMAL. 

===== THE LION ROARS TO ANNOUNCE POSSESSION OF A PROPERTY. 

===== THE KILLER WHALE EATS DOLPHINS, PORPOISES. SEALS, PENGUINS, AND 

===== SQUID. 

===== THE BOOKLOUSE CAN BE FOUND IN OLD BOOKS. IT FEEDS ON THE GLUE OF THE 

===== BINDINGS AND ON MOLDS THAT GROW ON OLD PAPER. 

I...+....1....+....2....+....3....+....4....+....5....+....6....+....7. 



ALTHOUGH PORCUPINE FISHES BLOW THEMSELVES UP AND ERECT THEIR SPINES, 
THEY ARE SOMETIMES EATEN BY SHARKS. NO ONE KNOWS WHAT EFFECT THIS 
HAS ON THE SHARKS. 
A FISH CALLED THE NORTHERN SEA ROBIN MAKES NOISES LIKE A WET 

X E D I T 1 File 



Figure 1. The ADD Subcommand — Before and After 



Chapter 3. XEDIT Subcommands and Macros 15 



ALL 



ALL (Macro) 



Format 



Use the ALL macro to display a specified collection of lines for editing, while 
excluding others from display. The collection is specified by a target that is 
repeatedly applied to the entire file, starting at the top of the file (or range). 



ALL 



[rtarget] 



Operand 



rtarget 

is a target that defines which lines are displayed. The target is "repeated," that 
is, it is appUed from the top of the file (or range) for as many times as necessary 
to collect all the lines in the file that correspond to the specified rtarget. For 
example, ALL/KEN/ displays all hnes in the file that contain the string "KEN". 
If no rtarget is specified, ALL displays the entire file. 

An rtarget may be specified as an absolute line number, a relative displacement, 
a Une name, or a string expression. For more information on targets, refer to 
the LOCATE subcommand in this book and to the VMjSP System Product 
Editor User's Guide. 



Usage Notes 



Messages 



1 . After you've used the ALL macro to make changes to selected lines in a file, you 
can redisplay the entire file, including the changes, by issuing the ALL macro by 
itself with no rtarget specified. All lines in the file are set to a selection level of 
and DISPLAY is set to 0. 

2. ALL modifies the SELECT setting of all of the lines in the file and overrides the 
DISPLAY and SCOPE settings. ALL sets the selection level of all selected Hnes 
to 1 and all nonselected lines are set to 0. After ALL is specified, the DISPLAY 
setting is set to 1 1 and SCOPE is set equal to DISPLAY. If you have used the 
SCREEN option, the DISPLAY setting is 1 1 for the view for which the ALL 
subcommand was entered, and unchanged for all other views. (Refer to SET 
SELECT, SET DISPLAY, SET SCOPE, and SET SCREEN in this pubhcation.) 

3. ALL does not change the SHADOW setting. (Refer to SET SHADOW in this 
publication.) The following example illustrates how ALL performs when SET 
SHADOW is "ON" (the default). When SET SHADOW is "OFF," then no 
notice is displayed to indicate that Hnes are not displayed. 



520E InvaUd operand: operand [RC = 5] 
546E Target not found [RC = 2] 
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ALL 



Return Codes 



Examples 



Normal 

2 Target not found 

5 Invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 



Figure 2 is an example of the ALL Macro. 

Elbert had a record collection for which he estabhshed a "names" file. He used the 
following organization scheme: 

NICK for opera 

C for classical 

COMPOSER Name of Composer 

NAME Name of Composition 

ADDRESS C or 0, depending on type, followed by the 
assigned number on the jacket. 



+ 



ELBERT NAMES AO V 255 Trunc=255 Size=17 Line=8 Co1=l Alt=0 

===== * * * 7qp of File * * * 

===== :nick.O : Composer. Puce i ni : name. LaBoheme 

===== :addr.01 

===== rnick.C .-Composer. Grieg:name. Peer Gynt Suites 

===== :addr.Cl 

===== :nick.C : Composer. Ravel : name. Piano Concerto in G Major 

===== :addr.C4 

I... + 1 + 2 + 3 + 4 + 5 + 6 + 7. 

===== :nick.C : Composer, Offenbach: name. Les Bavards 
===== :addr.C3 

===== :nick.O :Composer. Verdi rname.Aida 
===== :addr.02 

===== :nick.C :Compaser.Mozart:name.Eine kleine Nachtmusik 
===== :addr.C2 

====> all/nick. C/ 

X E D I T 1 File 

Using the ALL macro to select and display all classical records in Elbert's collection 
Figure 2 (Part 1 of 3). The ALL Macro 
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ALL 



ELBERT NAMES AG V 255 Trunc=255 Size=17 Line=4 Col=l Alt=0 



* * * Top of File * * * 

3 line(s) not displayed 

:nick.C : Composer. Grieg: name. Peer Gynt Suites 

I...+....1....+....2....+....3....+....4....+....5....+....6.. 

2 line(s) not displayed 

rnick.C :Composer. Ravel :name. Piano Concerto in G Major 

2 line{s) not displayed 

:nick.C : Composer. Offenbach: name. Les Bavards 

5 line(s) not displayed — 

:nick.C : Composer. Mozart: name. Eine kleine Nachtmusik 
1 line(s) not displayed 



* * * End of File * * * 



X E D I T 1 File 



Resulting file displaying all classical records 



ELBERT NAMES AG V 255 Trunc=255 Size=17 Line=4 Col=l Alt=G 



* * * Top of File * * * 

3 line(s) not displayed 

:nick.C :Composer.Grieg:name.Peer Gynt Suites 
I... + 1 + 2 + 3 + 4 + 5 + . 



2 line(s) not displayed 

:nick.C :Composer. Ravel :name. Piano Concerto in G Major 

2 line(s) not displayed 

:nick.C : Composer. Offenbach: name. Les Bavards 

5 line(s) not displayed 

:nick.C :Composer.Mozart:name.Eine kleine Nachtmusik 

1 line{s) not displayed 

* -^ * End of File * * * 



===> all/nick. 0/ 



X E D I T 1 File 



Using the ALL macro to select and display all operas in Elbert's collection 
Figure 2 (Part 2 of 3). The ALL Macro 
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ALL 



ELBERT NAMES AG V 255 Trunc=255 Size=17 Line=l Co1=l Alt=G 



* * * Top of File * * * 

rnick.O : Composer. Puccini :name.LaBoheme 

! ... + 1 + 2 + 3 + 4 + .. 



rnick.O 



■ -- 11 1ine(s) not displayed 

.•Composer. Verdi rname.Aida 

4 line(s) not displayed 

* * * End of File * * * 



===> set shadow off 



X E D I T 1 File 



Resulting file displaying all opera records 



ELBERT NAMES AG V 255 Trunc=255 Size=17 Line=l Col=l Alt=G 



* * * Top of File * * * 

rnick.O :Composer. Puccini :name.LaBoheme 

I... + 1.... + 2.... + 3.... + ....4 + .. 

rnick.O :Composer. Verdi :name.Aida 

* * * End of File * * * 






X X 



X E D I T 1 File 



File, displaying all opera records, with shadow Unes set off 
Figure 2 (Part 3 of 3). The ALL Macro 
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ALTER 



ALTER (Macro) 



Format 



Use the ALTER macro to change a single character to another character, one that 
may not be available on your terminal keyboard. The ALTER macro allows you to 
reference characters by their hexadecimal values. 



ALter 


char 1 char 2 


target 
1 


n 
* 

1 
G 


P 
1 





Operands 



charl 



Responses 



is the character to be altered. It may be specified either as a single character or 
in hexadecimal notation (00 through FF). 

charl 

specifies the character to which charl is to be altered. It may be specified either 
as a single character or in hexadecimal notation. 

target 

defines the number of hnes to be searched for charl. The search for charl starts 
with the current hne and continues up to, but does not include, the target line. 
If you specify an asterisk (*), the search continues to the end of the file (or the 
end of the range — see SET RANGE). If you omit target, only the current line 
is altered. 

A target may be specified as an absolute hne number, a relative displacement 
from the current hne, a hne name, or a string expression. For more information 
on targets, refer to the LOCATE subcommand in this book and to the 
publication VMjSP System Product Editor User's Guide. 

n 

is the number of occurrences of charl to be altered in each hne examined. If 
you specify an asterisk (*), all occurrences of charl are altered. If you omit n, 
only one occurrence of charl in each line is altered. For compatibihty with the 
CMS editor (EDIT), the G (Global) operand may be specified, but only when 
target is specified as a number. 

P 

specifies the relative number of the first occurrence of charl to be altered in each 
hne examined. If you omit p, the alteration starts with the first occurrence of 
charl in a hne. 



The column pointer remains unchanged. 

If SET STAY OFF is in effect (the default), the last hne examined becomes the new 
current line. 

If SET STAY ON is in effect, the hne pointer remains unchanged. 
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ALTER 



Messages 



Return Codes 



Examples 



When verification is on, every line that is changed is displayed. 

On a display terminal, when verification is off and a change has been made, the 
following message is displayed: 



5171 nn occurrence(s) changed on nn line(s) 



520E Invalid operand: operand [RC = 5] 

543 E InvaUd number: number [RC = 5] 

545E Missing operand(s) [RC = 5] 

546E Target not found [RC = 2] 

585E No Hne(s) changed [RC = 4] 



Normal 

1 TOP or EOF reached 

2 Target Hne not found 

4 No change occurred 

5 Missing or invalid operand or invalid number 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 



You can use ALTER to change a special character to a backspace character, in order to produce compound 
characters on printed output. 

Current Line: 

===== Please underline T$_H$_I$_S$_ 

alter $ 16 1 * (alter $ to X' 16' each time it appears in current line) 

===== Please underline T _H _I _S 

When printed, the line will look like this: 

Please underline THIS 
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BACKWARD 



BACKWARD 



Format 



Operand 



Use the BACKWARD subcommand to scroll backward toward the beginning of a 
file for a specified nimiber of screen displays. 




Usage Notes 



is the number of screen displays you want to scroll backward. If you specify an 
asterisk (*), the hne pointer moves to the "Top of File" hne. If you omit n, the 
screen scrolls back one display. 



1. The editor assigns the BACKWARD subcommand to the PF7 key. 

2. If you issue a BACKWARD subcommand when the current line is the "Top of 
File" hne, the editor "wraps around" the file, making the last line of the file the 
new current line. 

3. Issuing BACKWARD from anywhere in the file makes the last line of the file the 
new current line. 



Messages 



Return Codes 



520E Invahd operand: operand [RC = 5] 

529E Subcommand is only valid in {display [editing} mode [RC = 3] 

543 E Invahd number: number [RC = 5] 



Normal 

1 Top of File reached (subsequent BACKWARD restarts at end of file) 
3 Terminal is not a display 

5 Invahd operand or number 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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BOTTOM 



Format 



BOTTOM 



Use the BOTTOM subcommand to make the last line of the file or of the range (see 
the SET RANGE subcommand) the new current line. 



Bottom 



Usage Notes 



Message 
Return Codes 



1. One way to begin entering new lines at the end of a file is to issue the BOTTOM 
subcommand followed by the INPUT subcommand. 

2. While the BOTTOM subcommand moves the line pointer to the last file line, a 
LOCATE * subcommand moves it to the null "End of File" (or "End of 
Range") Une that follows the last Une of the file. Use LOCATE * instead of 
BOTTOM if you intend to follow with an upward search for the last occurrence 
of a string within a file, (because the upward search starts with the line preceding 
the current line). 



520E Invalid operand: operand [RC = 5] 



Normal 

5 Invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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CANCEL 



CANCEL (Macro) 



Format 



Usage Note 



Response 



Messages 



Return Codes 



Use the CANCEL macro when editing multiple files to terminate the editing session 
for all of the files. The CANCEL macro is equivalent to entering a QUIT 
subcommand for each file. 




1 . The QUIT that is issued against all the files is either protected or unprotected, 
depending on the defined synonyms (see the QUIT subcommand). If the QUIT 
subcommand has been defined to perform a protected QUIT, then CANCEL 
will quit all unmodified files but will issue a warning message for each modified 
file, leaving the user in edit mode. If all the files being cancelled were 
unmodified, the CANCEL macro causes an immediate exit from the editor. 



(if protected QUIT is defined): 



File has been changed; use QQUIT to quit anyway 



520E InvaUd operand: operand [RC = 5] 

577E File has been changed; type QQUIT to quit anyway [RC = 12] 



Normal 

5 Invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 

12 File has been changed (protected QUIT) 
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CAPPEND 



CAPPEND (Macro) 



Format 



Operand 



Usage Notes 



Response 
Messages 

Return Codes 



Use the CAPPEND macro to append specified text to the end of the current line. 




text 



is the text to be appended to the end of the current line. If no text is specified, 
the column pointer is placed under the first trailing blank. 



1. If SET SPILL OFF is in effect (the default), characters that have been pushed 
beyond the truncation column are truncated. If SET SPILL ON or SET SPILL 
WORD has been issued, characters that have been pushed beyond the truncation 
column are inserted in the file as one or more new lines, starting with the first 
character or word that would have gone beyond the truncation column. 

2. The text operand starts with the first character following the blank delimiter 
after the subcommand name. 

3. Column pointer movement is affected by the current zone setting. See the 
description of the SET ZONE subcommand for more complete information. 



The column pointer is placed under the first character of the appended text. 



503E {Truncated|Spilled}[RC = 3] 
585E No line(s) changed [RC = 4] 



Normal 

3 Truncated or spilled 

4 No lines changed 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 

subcommand has been issued in a macro called from the last file in the ring 
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CAPPEND 



Examples 



Current Line: 

===== It is an ancient mariner, 

!...+ 1 + 2 + 3 + 4 + 5 + 6 + 7. 

cappend and he stoppeth one of three. 

(one blank between subcommand name and operand) 

===== It is an ancient mariner, and he stoppeth one of three. 

<... + ....! +....2 + I...3.... + 4 + ....5 + 6.... + ....7. 

Current Line: 

===== It is an ancient mariner, 

I...+ 1 + 2 + 3 + 4 + 5 + 6 + 7. 

cappend and he stoppeth one of three. 

(two blanks between subcommand name and operand) 

===== It is an ancient mariner, and he stoppeth one of three. 

<...+ 1 + 2 +I...3 + 4 + 5 + 6 + 7, 
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CDELETE 



CDELETE 



Format 



Use the CDELETE subcommand to delete one or more characters from the current 
line, starting at the column pointer. 



CDelete 



[column-target |l] 



Operand 



Usage Notes 



column-target 

defines the number of characters to be deleted. Deletion starts at the column 
pointer and continues up to, but does not include, the column-target. 

For a complete description of column-targets, refer to the CLOCATE 
subcommand. 



1. Use the CLOCATE subcommand to move the column pointer to the column 
you want deletion to begin at. 

2. As with all column-targets, the following SET options have an effect on the 
column-target search: 



SET ARBCHAR 
SET CASE 
SET ETARBCH. 



SET SPAN 

SET VARBLANK 



3. When SET STREAM OFF has been issued, only the current line is searched for 
the string to be deleted. When SET STREAM ON has been issued, the editor 
searches for the string up to the end of the file (or range) or to the top of the file 
(or range) if the search is in a backward direction. In this case, several hnes may 
be deleted. 



Response 



If SET STREAM ON is in effect, and more than one line was deleted, the following 
message is displayed: 



Messages 



5011 nn 1ine(s) deleted 



520E Invalid operand: operand [RC = 5] 

546E Target not found [RC = 2] 

585E No line(s) changed [RC = 4] 

700E Logical AND operator & not valid for column targets [RC = 5] 
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CDELETE 



Return Codes 



Normal 

2 Target not found 

4 No line(s) changed 

5 Invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 



Examples 



Current Line: 

===== There are now more than 3,000 languages in the world. 

I...+....1....+....2....+....3....+....4....+....5....+....6....+....7. 

cl :11 (move the column pointer) 

cd :15 (delete characters from the column pointer to column 15) 

===== There are more than 3,000 languages in the world. 

<...+.... It... +....2.... +....3.... +....4.... +....5.... +....6.... +....7. 

Current Line: 

===== A dialect is considered a language if it is used in newspapers. 

I...+....1....+....2....+....3....+....4....+....5....+....6....+....7. 

cl :43 

cdelete _6 (delete characters in current column and 5 preceding ones) 

===== A dialect is considered a language if used in newspapers. 

<...+ 1 + 2 + 3....+ 4..I.+ 5 + 6 + 7, 
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CDELETE 



Current Line: 

===== Russian is spoken by 190 million people. 

I...+ 1 + 2 + 3 + 4 + 5.... + 6 + 1 ... 

cdelete /spoken/ (delete characters from the column pointer to the first character of the string) 

===== spoken by 190 million people. 

I...+....1....+....2....+....3....+....4....+....5....+....6....+....7... 

Current Line: 

===== Russian is spoken by 190 million people. 

I...+....1....+....2....+....3....+....4....+....5....+....6....+....7... 

cl :39 

cd -/190/ (delete characters from column pointer up to the first character of the string) 

===== Russian is spoken by 1. 

<...+ 1 + 2 + 3 +...14 + 5 + 6 + 1 ... 



Chapter 3. XEDIT Subcommands and Macros 29 



CFIRST 



CFIRST 



Format 



Use the CFIRST subcommand to move the column pointer to the beginning of the 
zone (see SET ZONE). 



CFirst 



Usage Note 

Message 
Return Codes 



Examples 



After subcoromands that move the column pointer have been executed, use the 
CFIRST subcommand to reset the column pointer to the left zone. 



520E Invalid operand: operand [RC = 5] 



Normal 

5 Invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 



Current Line: 

(Note the position of the column pointer.) 

===== The automobile heater was invented by a woman from Brooklyn. 

<...+....!.... +....2....+.... 3.... +....4I...+.... 5.... +....6.... +....7. 

cfirst 

===== The automobile heater was invented by a woman from Brooklyn. 

l.,.+....l....+....2....+....3....+....4 +....5.... +....6.... +....7, 
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CHANGE 



Format 



CHANGE 



Use the CHANGE subcommand to change a specified group of characters to 
another group of characters of the same or a different length. You can use the 
CHANGE subcommand to change more than one hne at a time. 







r r r r T T 




Change 


/ string 1 


/ string 2 / 


target 
1 


P 
* 

1 


1 








L L L L J J 





Operands 



/ (diagonal) 

signifies any deUmiting character that does not appear in the character strings 
involved in the change. 

stringl 

is a group of characters to be changed (old data). 

string2 

is the group of characters that is to replace stringl (new data). If stringl is 
omitted, it is assumed to be a null string. The traiUng deUmiter may be 
necessary in certain circumstances. For example, if string2 has trailing blanks, 
the traiUng delimiter should be used to indicate where the string ends. 

target 

defines the number of lines to be changed. Lines are changed starting with the 
current line, up to but not including the target line. If you specify an asterisk 
(*), hnes are changed until the end of the file (or the end of the range). If you 
omit target, only the current line is changed. 

A target may be specified as an absolute line number, a relative displacement 
from the current line, a hne name, or a string expression. For more information 
on targets, refer to the LOCATE subcommand in this book and to the VMjSP 
System Product Editor User's Guide. 

P 

is the number of occurrences of stringl to be changed in each hne. If you 
specify *, stringl is changed every time it appears in a Hne. If you omit p, 
stringl is changed only once. 

is the relative number of the first occurrence of stringl to be changed in each 
line. If you omit q, the change starts with the first occurrence of stringl in each 
Une. 
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CHANGE 



Usage Notes 



1. The first nonblank character following the CHANGE subcommand is considered 
to be the delimiter. 

For example: 

change .VM/370.CMS. changes VM/370 to CMS 

2. If string2 is longer than stringl, and if SET SPILL OFF is in effect (the default), 
characters that have been pushed beyond the truncation column are truncated. 
If SET SPILL ON or SET SPILL WORD has been issued, characters that have 
been pushed beyond the truncation column are inserted in the file as one or 
more new lines, starting with the first character or word that would have gone 
beyond the truncation column. If a line is spilled, no additional changes will be 
made on that Hne. 

If string2 is shorter than stringl, characters are shifted left (from the truncation 
column), and the line is padded with blanks (up to the truncation column). 

3. If stringl is represented as a null string, string2 is inserted in the line, starting at 
the beginning of the zone, which may or may not be column 1. 

4. Using CHANGE with SET ARBCHAR ON: 

set arbchar on . 
change /(.)/'.'/ 

The expression that was in parentheses is now enclosed by quotation marks. 

change /(.)// 

String2 is represented as a null string. As a result, the expression in parentheses 
(and the parentheses) is deleted. 

set arbchar on $ 
change /y$/y/ 

results in all characters following y being deleted, ending at zone 2 (not 
truncation column). Characters from zone 2 to the truncation column are 
shifted left and the line is padded with blanks (up to the truncation column). 

For additional examples of using CHANGE with SET ARBCHAR, refer to the 
"Examples" section below and to the SET ARBCHAR subcommand 
description. 

To use CHANGE with SET ETARBCH see Appendix F, "Using Double-Byte 
Character Sets" on page 419. 

5. Using SET CASE and CHANGE: 

Stringl should be typed exactly as it appears in the file in order for it to be 
changed (with SET CASE MIXED). 

6. Using SET STAY and CHANGE: 

If you specify that a change is to occur on multiple lines and the change occurs, 
the current hne pointer will be: 

a. Unchanged, if SET STAY ON has been entered 

b. Moved to the last line scanned, if SET STAY OFF is in effect (the default). 

7. Using SET ZONE and CHANGE: 

The search for stringl occurs only between the left and right zones. However, 
characters are shifted left or the line is padded with blanks from the right zone 
up to the truncation column, as explained in usage note 2. 
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Responses 



Messages 



Return Codes 



CHANGE 



set arbchar on $ 
change /$/xy/ 

results in all characters from zone 1 through zone 2 (not the truncation column) 
being replaced by characters xy. Characters from zone 2 to the truncation 
column are shifted left and the line is padded with blanks (up to the truncation 
column). 

8. The search for string 1 is not affected by the setting of SET SPAN or SET 
VARBLANK. 

9. The CHANGE subcommand updates the LASTLORC buffer. Refer to the SET 
LASTLORC subcommand in this publication. 



On a typewriter terminal, when verification is on, every line that is changed is 
displayed. 

On a display terminal, when verification is off and a change is made, one of the 
following messages is displayed: 



518E nn occurrence(s) changed on nn line(s); 

nn line(s) {truncated | spilled} [RC=3] 
5171 nn occurrence(s) changed on nn line(s) 



503E {Truncatedl Spilled} [RC = 3] 

511E String2 contains more arbitrary characters than string 1 [RC = 5] 

520E Invalid operand: operand [RC = 5] 

543 E Invalid number: number [RC = 5] 

545E Missing operand(s) [RC = 5] 

546E Target not found [RC = 2] 

58 5E No hne(s) changed [RC = 4] 



Normal 

1 TOP or EOF reached during change 

2 Target line not found 

3 Truncation or spill occurred during the change 

4 No change occurred, (string 1 has not been found) 

5 Invalid or missing operand or number 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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CHANGE 
Examples 

Current Line: 

===== A rose Is a rose is a rose. 

change/rose/daisy/ (change first occurrence in the current line) 

===== A daisy is a rose is a rose. 

change/rose/daisy/ 1 * (change all occurrences in the current line) 

===== A daisy is a daisy is a daisy. 

The following subcommand would change every occurrence of "rose" to "daisy" in every line of the file, 
beginning with the current line. 

change/rose/daisy/ * * 

Current Line: 

===== James Bernard is my favorite artist. 

change//Mr. / (insert "Mr. " in column 1) 

===== Mr. James Bernard is my favorite artist. 

Using CHANGE with SET ARBCHAR ON: 

=== Lewis Carroll wrote (The Walrus and the Carpenter). 

change/($)/"$"/ (change parentheses to quotation marks) 

===== Lewis Carroll wrote "The Walrus and the Carpenter". 

===== Robert Browning wrote (among other things) "My Last Duchess". 

change / ($)// (string2 is a null string) 

===== Robert Browning wrote "My Last Duchess". 
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CINSERT 



CINSERT 



Format 



Operand 



Use the CINSERT subcommand to insert text in the current Une starting at the 
column pointer. As a result, the data is shifted to the right. 




text 



is the group of characters to be inserted starting at the column pointer. 



Usage Notes 



1. You can insert blanks with the CINSERT subcommand. The operand must 
contain the nxmiber of blanks you want to insert. (You cannot enter the 
CINSERT subcommand without an operand.) 

2. If SET SPILL OFF is in effect (the default), characters that have been pushed 
beyond the truncation column are truncated. If SET SPILL ON or SET SPILL 
WORD has been entered, characters that have been pushed beyond the 
truncation column are inserted in the file as one or more new lines, starting with 
the first character or word that would have gone beyond the truncation column. 

3. Use the CLOCATE subcommand to move the column pointer to the desired 
location. 



If the column pointer is at Zonel 
will be inserted. 



1 (TOL) or Zone2 + 1 (EOL), no characters 



Response 
Messages 



The column pointer remains unchanged. 



503E {Truncatedl Spilled} [RC = 3] 
545E Missing operand(s) [RC = 5] 
585E No line(s) changed [RC = 4] 
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CINSERT 



Return Codes 



Example 



Normal 

3 Truncated or spilled 

4 No line(s) changed 

5 Missing operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 



Current Line: 



Mount Everest is high. 
I. ..+....1.. ..+... .2....+. 



cl /high/ (move the column pointer) 

ci exactly 29,000 feet (one blank entered after "feet" for spacing) 

===== Mount Everest 1s exactly 29,000 feet high. 

<...+ 1 +..I.2 + 3 + 4 + 5 + 
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CLAST 



CLAST 



Format 



Message 
Return Codes 



Examples: 

set zone 1 20 
Current Line: 



Use the CLAST subcommand to move the column pointer to the end of the zone 
(see SET ZONE). 




520E Invahd operand: operand [RC = 5] 



Normal 

5 Invahd operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 



Harvey Kennedy invented the shoelace and made $2.5 million. 
I...+ 1 + > + 3 + 4 + 5 + 6. 



.+....7, 



clast 



=== Harvey Kennedy invented the shoelace and made $2.5 million. 
<...+ 1 + 1 + 3 + 4 + 5 + 6. 



.+....7, 
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CLOCATE 



CLOCATE 



Use the CLOCATE subcommand to scan the file for a specified column-target, and 
to move the column pointer to the target, if located. The search begins with the 
column following (or preceding) the column pointer in the current hne. The 
CLOCATE subcommand is used to find successively all occurrences of a character 
string and to move the column pointer if the string is found. 



Format 



CLocate 



column-target 



Operand 

column-target 

can be specified as an absolute column number, a relative column nimiber, a 
string expression, or a complex string expression. A complete description of 
column-targets follows, under "Usage Notes." 

Usage Notes — Column-targets 

A column-target is a specialized operand used only in the CLOCATE and 
CDELETE subcommands. 

It is not to be confused with the target operand used in many other XEDIT 
subcommands and macros. That kind of target is actually a line target. When a Hne 
target is found, the Hne pointer is moved, but the column pointer is not moved. If a 
Hne target is expressed as a string, only the first occurrence of the string will be 
located in each Hne, regardless of how many times the string appears in a line. For 
example, if a Hne contains more than one occurrence of the string "ABC" and you 
issue a LOCATE subcommand for it, the Hne pointer moves to that Hne. If the 
same LOCATE subcommand is repeated, the line pointer would move to the next 
Hne containing "ABC". 

On the other hand, when a column-target is expressed as a string and that string is 
found, the column pointer is moved to the first character of the string. If the string 
appears in this line more than once, repeated CLOCATE subcommands move the 
column pointer to the first character of the string for each occurrence located. In 
addition, if SET STREAM ON is in effect (the default), the line pointer is also 
moved, making it possible to locate all occurrences of the string throughout the file 
(by repeated executions of the CLOCATE subcommand). 

The CLOCATE subcommand is used to move the column pointer to a specified 
column or to locate a specified string; the colunm pointer is moved if the string is 
found. 

A column-target may be expressed in the foUowing ways: 

1. Kn absolute column number is usQd to mo\Qthd cohjmxLT^omiQT. It is expressed 
as a colon followed by an integer. For example: 

clocate :2 

moves the column pointer to column 2 of the current Hne. 
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CLOCATE 



Use this form of the CLOCATE subcommand when you plan to enter 
subsequently a subcommand that starts its operation at the column pointer, for 
example, JOIN COLUMN. 

A relative column number is used to move the column pointer. It is expressed as 
an integer and may be preceded by a plus (+) or minus ( — ) sign, which 
indicates a right ( + ) or left ( — ) move. If the sign is omitted, a plus ( + ) is 
assumed. 

For example: 

clocate +2 
clocate 2 

both move the column pointer two columns to the right of its current position. 
A relative column number may also be specified as an asterisk (*), which means 
one column to the left of the left zone (- *) or one column to the right of the 
right zone ( + * or *). By using CLOCATE — * or * first, you can then use 
CLOCATE to find a string, even if it is in the first or last column of the zone. 
You can determine when the column pointer has reached either Zonel — 1 or 
Zone2 + 1 by using the TOL (Top of Line) or EOL (End of Line) operands on 
the QUERY or EXTRACT subcommand. 

A string expression defines a group of characters to be located, starting with the 
column immediately following (or preceding, depending on the direction of the 
search) the current column. 

If SET HEX ON has been issued, a string may be specified in hexadecimal 
notation, and the EBCDIC equivalent will be searched for. 

The format of a string expression is: 



[+t-][-]/stringl[/|[-.]/string2/]. 
12 3 4 



^ Right ( + ) or left ( — ) search (right is the default) 

^ "NOT" symbol (locate something that is not the specified string) 

^ character (or hexadecimal) string. The traiUng delimiter may be necessary 
in certain circumstances. For example, if string 1 has trailing blanks, the 
trailing delimiter should be used to indicate where the string ends. 

* "OR" symbol (vertical bar) (locate any of the strings, separated by OR 
symbols, starting with the first string specified). 

Examples 

clocate /horse/ 

searches the file for the first occurrence of "horse," starting at the first 

character following the column pointer, 
clocate -/horse/ 

searches backward for the first occurrence of "horse," starting at the first 

character preceding the column pointer, 
clocate -i/horse/ 

searches for the first occurrence that is not "horse," starting at the first 

character following the column pointer, 
clocate /horse/ I /buggy/ 
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CLOCATE 



searches each line for "horse," even if "buggy" occurs before "horse" in 
the hne. If "horse" is not found, then searches the Hne for "buggy," and 
if neither is found, the search is repeated until the end (or top) of the 
file. 

clocate // 

advances the column pointer one column. 

4. A complex string expression can have the same format as a string expression (see 
above), but any string can be expressed as a "complex string," which is defined 
as a string associated with one or more of the following SET subcommand 
options: 

ARBCHAR 

CASE 

ETARBCH 

SPAN 

VARBLANK. 

See the LOCATE subcommand for a description of these options. 

5. SET STREAM is meaningful only with column-targets. 

stream on 

specifies that each line is searched for a string that matches the 
column-target starting with the character following (or preceding) the 
column pointer on the current line and continues to the end (or top) of 
the file (or range) until a match is found. STREAM ON is the default 
setting. 

If SET WRAP is also ON (OFF is the default) and the editor "wraps 
around" the file (see SET WRAP) if the top of file (or range) or end of 
file (or range) is reached during a CLOCATE, the following warning 
message is displayed: 

b92W Wrapped 

stream off 

specifies that the search is confined to the current line (or zones within 
the line). 

6. The CLOCATE subcommand updates the LASTLORC buffer. Refer to the 
SET LASTLORC subcommand in this pubUcation. 



Messages 

520E Invalid operand: operand [RC = 5] 



545 E Missing operand(s) [RC = 5] 

546E Target not found [RC = 2] 

592W Wrapped .... 

700E Logical AND operator & not valid for column targets [RC = 5] 
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Return Codes 



CLOCATE 



Normal 

1 Out of zone definition during execution 

2 Target not found (character pointer stays where it was) 

5 Invalid or missing operand(s) 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 



Examples 



Current Line: 

===== John Keats studied medicine and practiced as an apothecary. 

I...+....1....+....2....+....3 +....4.... +....5.... +....6.... +....7, 

clocate :6 (absolute column number) 

===== John Keats studied medicine and practiced as an apothecary. 

<...+|...l....+....2....+....3....+....4....+....5....+....6....+....7, 

Current Line: 

===== James Joyce was a school teacher in Dublin. 

I...+....1....+....2....+....3....+....4....+....5....+....6....+....7, 

clocate +6 (relative column number) 

===== James Joyce was a school teacher in Dublin. 

<...+. |..l + 2 + 3 + 4 + 5 + 6 + 7. 

Current Line: 

===== Herman Melville worked as a customs inspector in N.Y.C. 

I...+ 1 + 2 + 3 + 4 + 5 + 6 + 7. 

clocate /customs/ 

===== Herman Melville worked as a customs inspector in N.Y.C. 

<...+ 1 + 2 +...I3 + 4 + 5 + 6 + 7. 

Current Line: 

===== Charles Dickens served as a law clerk and was a reporter. 

I...+....1....+....2....+....3....+....4....+....5....+....6....+....7, 

clocate /reporter/ 1 /clerk/ (locate "reporter" or "clerk") 

===== Charles Dickens served as a law clerk and was a reporter. 

<...+ 1 + 2 + 3 + 4 +...I5 + 6 + 7. 
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CMS 



CMS 



Format 



Operand 



Use the CMS subcommand to have the editor transmit a command to CMS for 
execution, or to have the editor enter CMS subset mode. 




commandline 

is any CMS command. If no command is specified, the editor enters CMS 
subset mode. 



Usage Notes 



Responses 



1 . If you enter the CMS subcommand without an operand, you enter CMS subset 
mode. For a description of CMS subset mode, please refer to the VM/SP CMS 
User's Guide. You must use the CMS subset command RETURN to return to 
edit mode. 

2. If you try to execute a CMS command that terminates abnormally, changes 
made during your editing session might be lost. You should save the input you 
have entered before you use the CMS subcommand. 

3. Any CMS command should be prefaced with 'CMS' to prevent XEDIT from 
decoding the subcommand. This should be done to prevent cases when CMS 
commands may be interpreted as XEDIT subcommands. 

4. Some CMS commands issue either informational messages or error messages to 
the XEDIT environment. While in CMS subset mode, you will not see these 
messages until you return to XEDIT unless MSGLINE is set OFF or the 
maximum number of message lines has been exceeded. However, you will see 
the return code associated with the message as part of the CMS ready message. 



When you enter the CMS subcommand without an operand, the following message 
is displayed: 



CMS subset 

This indicates you are in CMS subset mode. If full-screen CMS is ON (via the SET 
FULLSCREEN ON command), the message will appear in the CMS window 
connected to the virtual screen. Also, the STATUS window will be popped. If 
full-screen CMS is OFF, the editor clears the screen before issuing the CMS 
SUBSET message. To return to the XEDIT environment when full-screen CMS is 
ON or OFF, use the CMS RETURN command. 

When you enter a CMS subcommand with an operand and the CMS command does 
not write on the screen, the file image remains on the screen. 
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Messages 



Return Codes 



CMS 



If full-screen CMS is ON and the CMS command displays text, then the text will 
appear in the CMSOUT window. (Text will appear in the CMSOUT window by 
default; you can route the text to another window by using the CMS ROUTE 
command, explained in the VMjSP CMS Command Reference). To see all of the 
text in the virtual screen, you can use the CMS SCROLL command. The screen will 
be cleared automatically when you scroll to the bottom of the virtual screen. An 
alternative way to clear the screen is to issue the CMS DROP WINDOW command. 
If you delete the CMSOUT window, you won't see messages that are passed to 
CMS. 

If full-screen CMS is OFF, the text replaces the file image on the screen and the 
terminal is placed in a "MORE..." (waiting) status. To get the file image back on the 
screen, either press the CLEAR key or wait for one minute. 

If the return code from the CMS command is a negative number other than -2, the 
message 'Unknown CP/CMS coromand' will be issued. For -2, the message Tnvahd 
subset command' is issued. 



5 12E Invahd subset command [RC = -2] 

5 1 3E Unknown CP/CMS command [RC = -3] 

514E Return code nn from command \K.C=nri\ 



-2 Invahd subset command 
-3 Unknown CMS/CP command 
Normal 
6 Subcommand rejected in the profile due to LOAD error, or QUIT 

subcommand has been issued in a macro called from the last file in the ring 
-nn Unknown CP/CMS command 
nn The return code of the CMS command after RETURN to XEDIT 

environment 
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CMSG 



CMSG 



Format 



Use the CMSG subcommand to display a message in the command hne of the 
terminal. The CMSG subcommand is intended to be issued from a macro. 



CMSG 



[^crjfif] 



Operand 



Usage Notes 



text 



is the text of the message to be displayed. If no text is specified, the command 
line is reset to a blank line. 



1. If it is issued to a typewriter terminal, the CMSG subcommand has no effect. 

2. If it is issued when the cmdline is off, the CMSG subcommand has no effect. 

3. If it is issued when the stack is not empty, the CMSG subcommand has no 
effect. 

Notes for Macro Writers 

When issued from a macro, CMSG can be used to redisplay input that the user has 
entered incorrectly, so that the input can be corrected and reentered. 



Response 
Return Codes 



The message is displayed in the command line. 



Normal 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 

subcommand has been issued in a macro called from the last file in the ring 
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COMMAND 



COMMAND 



Format 



Use the COMMAND subcommand to have the editor execute an XEDIT 
subcommand without first checking for identically-named synonyms and macros. 



COMMAND 



icommandline] 



Operand 



Usage Notes 



Response 
Messages 

Return Codes 



commandline 

is any XEDIT subcommand name and its operands, except for ? and &. 



1. The editor executes the specified subcommand even if the SET SYNONYM ON 
or SET MACRO ON subcommands have been issued. In other words, the 
editor does not check to see if a synonym or macro with the same name exists 
before it executes the specified subcommand. 

2. If SET IMPCMSCP ON is in effect, any commands not recognized by the editor 
will be transmitted to CMS or to CP. 



The response, if any, from the executed subcommand is displayed. 

542E No such subcommand: name [RC = -1] 

Error messages from the executed subcommand (if any) are displayed. 



nn Return code of the subcommand specified as operand 
-1 No such subcommand 

Normal 

6 Subconmiand rejected in the profile due to LOAD error or QUIT 

subcommand has been issued in a macro called from the last file in the ring 
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COMPRESS 



COMPRESS 



Format 



Operands 



Usage Notes 



Responses 



Use the COMPRESS subcommand to prepare one or more file lines, starting with 
the current line, for automatic repositioning of data according to new tab column 
settings. Use the SET TABS subcommand to define new tab column settings. 




target 

defines the number of Hnes to be compressed, starting with the current hne, up 
to, but not including, the target hne. If you specify an asterisk (*), the rest of 
the file is compressed. If you omit target, only the current line is compressed. 

A target may be specified as an absolute Hne number, a relative displacement 
from the current hne, a hne name, or a string expression. For more information 
on targets, refer to the LOCATE subcommand in this book and to the VMjSP 
System Product Editor User's Guide. 



1. After you compress a hne, you can use the SET TABS and EXPAND 
subcommands to reposition the data in the new tab columns. 

Using this sequence of commands: 

set tabs ... 
compress . . . 
set tabs . . . 
expand ... 

you can realign an entire table. 

2. For COMPRESS to work properly, lines containing backspace characters 

(X' 16') must have been entered into the file with SET IMAGE CANON; that 
is, compound characters ordered with backspaces arranged singly between the 
characters that overlay each other. 

3. Lines are compressed according to the current SET TABS setting. The 
COMPRESS subcommand removes all contiguous blank characters (or whatever 
character is defined as a filler character by the SET FILLER subcommand) that 
immediately precede the current tab columns. It replaces each group of blank 
(or filler) characters with a tab character (X'05'). 



1 . If you specify that a compress is to occur on multiple hnes and the compress 
occurs, the current line pointer will be: 

a. Unchanged, if SET STAY ON has been entered 

b. Moved to the last line compressed, if SET STAY OFF is in effect (the 
default). 

2. The data in a compressed Une shifts left, reflecting the removal of blanks. 
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COMPRESS 



Messages 



520E Invalid operand: operand [RC = 5] 

546E Target not found [RC = 2] 

58 IE Subcommand is not valid in extended mode [RC 

585E No line(s) changed [RC = 1 or 41 



3] 



Return Codes 



Normal 

1 TOF or EOF reached during execution 

2 Target line not found 

3 Subcommand is not valid in extended mode 

4 No line(s) changed 

5 Invahd operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 



Examples 



Figure 3, Figure 4, and Figure 5 are examples of using the COMPRESS and 
EXPAND subcommands to reahgn data in a table. 



REALIGN SAMPLE Al F 80 Trunc=80 Size=14 Line=3 Col=l Alt=0 



* * * Top of File * * * 

COUNTRIES WITH HIGHEST LIFE EXPECTANCIES 

COUNTRY MEN WOMEN 

|. ..+....!....+... .2. ...+.. ..3. ...+.. ..4. 

SWEDEN 71.8 76.5 

NETHERLANDS 71.0 76.4 

ICELAND 70.8 76.2 

NORWAY 71.0 76.0 

DENMARK 70.6 75.4 

CANADA 68.7 75.2 

FRANCE 68.0 75.5 

JAPAN 69.0 74.3 

U.K. 68.5 74.7 

compress +10 



X E D I T 1 File 



Figure 3. Realigning a Table (Current tab setting is 1 15 20) - COMPRESS 
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COMPRESS 



REALIGN SAMPLE Al F 80 Trunc=8Q Size=14 Line=12 Col=l Alt=l 

===== COUNTRYMENWOMEN 
===== SWEDEN71.876.5 
===== NETHERLANDS71.076.4 
===== ICELAND70.876.2 
===== N0RWAY71. 076.0 
===== DENMARK70.675.4 
===== CANADA68. 775.2 
===== FRANCE68.075.5 
===== JAPAN69.074.3 
===== U.K. 68. 574. 7 

|... +....!.... +....2.... +....3....+ 4....+....5....+....e 

===== * * * End of File * * * 



=> set tabs 1 30 50 # -/COUNTRY/ # expand +10 



Figure 4. Realigning a Table - Set New Tabs and EXPAND 



X E D I T 1 File 



REALIGN SAMPLE Al F 80 Trunc=80 Size=14 Line=12 Col=l Alt=2 

===== COUNTRY MEN WOMEN 

===== SWEDEN 71.8 76.5 

===== NETHERLANDS 71.0 76.4 

===== ICELAND 70.8 76.2 

===== NORWAY 71.0 76.0 

===== DENMARK 70.6 75.4 

===== CANADA 68.7 75.2 

===== FRANCE 68.0 75.5 

===== JAPAN 69.0 74.3 

===== U.K. 68.5 74.7 

|...+....l....+....2....+....3....+....4....+....5....+....f 

===== * * * End of File * * * 



Figure 5. Realigning a Table — Realigned Table 



X E D I T 1 File 
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COPY 



Format 



COPY 



Use the COPY subcommand to copy one or more lines, beginning with the current 
hne, at a specified location in the file. 



copy 



target 1 target 2 



Operands 



Responses 



Messages 



Return Codes 



targe tl 

defines the number of lines to be copied. Lines are copied starting with the 
current line, up to but not including target 1 . 

A target may be specified as an absolute Une number, a relative displacement 
from the current line, a line name, or a string expression. For more information 
on targets, refer to the LOCATE subcommand in this book and to the VM/SP 
System Product Editor User's Guide. 

target! 

defines the line after which the data is to be copied. 



The last hne that was copied becomes the new current line. 
The editor displays the following message: 

5061 nn lines copied 



520E InvaHd operand: operand [RC = 5] 

545E Missing operand(s) [RC = 5] 

546E Target not found [RC = 2] 

557S No more storage to insert lines [RC = 4] 



Normal 

2 Target Une not found 

4 No more storage available 

5 Missing or invaUd operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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COPY 



Examples 



Figure 6 is a before-and-after example of the COPY subcommand. 



ANIMALS FACTS 



Al V 80 Trunc=8Q Size=26 Line=15 Col=l Alt=0 



0OGO6 SLEEP UNDER WATER. 

0OGQ7 A LIZARD OF CENTRAL AMERICA CALLED THE BASILISK CAN RUN 

00008 ACROSS WATER. 

00009 OCTOPI HAVE LARGE BRAINS AND SHOW CONSIDERABLE CAPACITY FOR 

00010 LEARNING. 

00011 THE ARMADILLO IS THE ONLY ARMORED MAMMAL. 

00012 THE LION ROARS TO ANNOUNCE POSSESSION OF A PROPERTY. 

00013 THE KILLER WHALE EATS DOLPHINS, PORPOISES, SEALS, PENGUINS, AND 
Q0014 SQUID. 

00015 THE BOOKLOUSE CAN BE FOUND IN OLD BOOKS. IT FEEDS ON THE GLUE OF THE 
|...+....l....+....2...,+....3....+....4....+....5....+....6....+....7.. 

00016 BINDINGS AND ON MOLDS THAT GROW ON OLD PAPER. 

00017 ALTHOUGH PORCUPINE FISHES BLOW THEMSELVES UP AND ERECT THEIR SPINES. 

00018 THEY ARE SOMETIMES EATEN BY SHARKS. NO ONE KNOWS WHAT EFFECT THIS 

00019 HAS ON THE SHARKS. 

00020 A FISH CALLED THE NORTHERN SEA ROBIN MAKES NOISES LIKE A WET 

00021 FINGER DRAWN ACROSS AN INFLATED BALLOON. 

00022 STINGAREES, FISH FOUND IN AUSTRALIA, CAN WEIGH UP TO 800 POUNDS 

00023 AND HAVE THE MOST POTENT VENOM OF ALL FISH. 

00024 OSTRICHES CAN KICK LIKE A MULE, IMITATE A LION'S ROAR, AND HISS LIKE 
====> copy 2 :4 

X E D I T 1 File 



ANIMALS FACTS 
2 lines copied. 



Al V 80 Trunc=80 Size=28 Line=4 Col=l Alt=l 



00000 * * * Top of File * * * 

00001 CHAMELEONS, REPTILES THAT LIVE IN TREES, CHANGE THEIR COLOR WHEN 
0Q002 EMOTIONALLY AROUSED. 

I...+....1....+....2....+....3....+....4....+....5....+....6....+....7.. 
OG0O3 THE GUPPY IS NAMED AFTER THE REVEREND ROBERT GUPPY, WHO FOUND THE FISH 

00004 ON TRINIDAD IN 1866. 

00005 THE BOOKLOUSE CAN BE FOUND IN OLD BOOKS. IT FEEDS ON THE GLUE OF THE 

00006 BINDINGS AND ON MOLDS THAT GROW ON OLD PAPER. 

00007 AN AFRICAN ANTELOPE CALLED THE SITATUNGA HAS THE RARE ABILITY TO 

00008 SLEEP UNDER WATER. 

00009 A LIZARD OF CENTRAL AMERICA CALLED THE BASILISK CAN RUN 

00010 ACROSS WATER. 

00011 OCTOPI HAVE LARGE BRAINS AND SHOW CONSIDERABLE CAPACITY FOR 

00012 LEARNING. 

00013 THE ARMADILLO IS THE ONLY ARMORED MAMMAL. 

X E D I T 1 File 



Figure 6. The COPY Subcommand — Before and After 
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COUNT 



Format 



COUNT 



Use the COUNT subcommand to display the number of times a specified character 
string appears in one or more lines, starting with the current Une. 



count 



j string [/target |l] 



Operands 



Usage Notes 



Responses 



string 

is the character string to be counted. 

target 

defines the number of lines to be searched. The search begins with the current 
line and continues up to, but does not include, the target line. If you specify an 
asterisk (*), the search continues to the end of file (or the end of range— see SET 
RANGE). If you omit target, only the current line is searched. 

A target may be specified as an absolute line number, a relative displacement 
from the current line, a Une name, or a string expression. For more information 
on targets, refer to the LOCATE subcommand in this book and to the VMfSP 
System Product Editor User's Guide. 



1 . The count corresponds to the number of strings that would be changed by a 
CHANGE subcommand. 

2. Arbitrary characters (see the SET ARBCHAR subcommand) can be specified in 
the [string! operand. 

For example: 

set arbchar on $ 
count /($)/ * 

will count all of the expressions enclosed in parentheses. 

3. In a macro, you can use EXTRACT/LASTMSG/ to get the number of 
occurrences. 

4. The string should be typed exactly as it appears in the file in order for it to be 
counted. 



If you specify that a COUNT is to occur on multiple lines and the count occurs, the 
current Une pointer will be: 

a. Unchanged, if SET STAY ON has been entered 

b. Moved to the last Une scanned, if SET STAY OFF is in effect (the default). 
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COUNT 



Messages 



Return Codes 



The editor displays the number of times the string appears with the following 
message: 

5221 nn occurrences 



520E Invalid operand: operand [RC = 5] 
545E Missing operand(s) [RC = 5] 
546E Target not found [RC = 2] 



Normal 

1 TOF or EOF reached during execution 

2 Target Une not found 

5 Missing or invalid operand(s) 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 



Examples 



Current Line: 

===== A rose is a rose is a rose, 
count/rose/ 
Response: 
5221 3 occurrences 
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COVERLAY 



COVERLAY 



Format 



Use the COVERLAY subcommand to replace selectively one or more characters in 
the current line with the corresponding characters in the text that is keyed in. 
Replacement starts at the column pointer. 



COVerlay 



text 



Operand 



Usage Notes 



text 



is a group of characters that replaces characters in corresponding positions in the 
current line. 



1 . Blank characters in the text operand indicate that the corresponding characters 
in the current line are not to be overlaid. 

For example: 



Current line: 

COVERLAY subcommand: 
Result: 



ABCDE 

cover! ay MN PQ 

MNCPQ 



Messages 



2. An underscore character (J is used in the text operand to place a blank in the 
corresponding character position in the current Une. 

Therefore, you cannot use this subcommand to place an underscore character in 
a Une. 

Use the COVERLAY command carefully if a line contains underscored words 
or other compound characters. 

3. If SET SPILL OFF is in effect (the default), characters that have been pushed 
beyond the truncation colmnn are truncated. If SET SPILL ON or SET SPILL 
WORD has been entered, characters that have been pushed beyond the 
truncation column are inserted in the file as one or more new Unes, starting with 
the first character or word that would have gone beyond the truncation column. 

4. If the column pointer is at Zonel — 1 (TOL) or Zone2 + 1 (EOL), no characters 
will be overlaid. 



503E {TruncatedlSpilled} [RC = 3] 

545E Missing operand(s) [RC = 5] 

58 IE Subcommand is not valid in extended mode [RC = 3] 

585E No Une(s) changed [RC = 4] 
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COVERLAY 



Return Codes 



Examples 



Normal 

3 Truncated or spilled, or subcommand is not valid in extended mode 

4 No lines changed 

5 Missing operand(s) 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 



Current Line: 



Shall I compare thee to a summer's day? 
I...+....1 +....2.... +....3.... +....4. 



cl /summer/ (move the column pointer) 

GOV winter night? (blanks are not overlaid) 



Shall I compare thee to a winter's night? 
<...+ 1 + 2 +.1..3 + 4 +. 
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CP 



CP 



Format 



Operand 



Usage Note 



Responses 



Message 
Return Codes 



Use the CP subcommand to transmit commands to the VM/SP control program 
environment during an editing session. 




commandline 

is any CP command valid for your CP command privilege class. If you specify 
this operand, the editor transfers the command to CP and automatically returns 
to the editor environment. If you omit this operand, the editor enters the CP 
console function mode, where you can enter CP commands without preceding 
each command with CP. To return to the edit environment, enter the CP 
command BEGIN. 



1. Any CP command should be prefaced with "CP" to prevent the editor from 
mistaking the CP command for an XEDIT subcommand. 



When you issue the CP subcommand with an operand, and the CP command does 
not write on the screen, the file image remains on the screen. 

If full-screen CMS is ON and the CP command displays text, text will appear in the 
CMSOUT window. Text will appear in the CMSOUT window by default; you can 
route the text to another window by using the CMS ROUTE command, explained in 
the CMS Command Reference. To see all of the text in the virtual screen, you can 
use the CMS SCROLL command. The screen will be cleared automatically when 
you scroll to the bottom of the virtual screen. An alternative way to clear the screen 
is to issue the CMS DROP WINDOW command. If you delete the CMSOUT 
window, you won't see messages that are passed to CMS. 

If full-screen CMS is OFF, the text replaces the file image on the screen and the 
terminal is placed in a "MORE..." (waiting) status. To get the file image back on 
the screen, either press the CLEAR key or wait for one minute. 



5 1 3E Unknown CP/CMS command [RC = -3] 



Normal 

— 3 Unknown command 
nn Return code of the CP command 
6 Subcommand rejected in the profile due to LOAD error, or QUIT 

subcommand has been issued in a macro called from the last file in the rins 



Chapter 3. XEDIT Subcommands and Macros 55 



CREPLACE 



CREPLACE 



Format 



Use the CREPLACE subcommand to replace one or more characters in the current 
line with a specified character or group of characters, starting at the column pointer. 



CReplace 



text 



Operand 



text 



specifies those characters that are to replace characters in the current line, 
operand may contain all blanks, or it may contain imbedded blanks. 



This 



Usage Notes 



Messages 



Return Codes 



1 . Characters in the current line are replaced, one-for-one, with characters in the 
operand. 

2. No shifting occurs, as with deletion or insertion of characters. 

3. Use the CLOCATE subcommand to move the column pointer to the desired 
location. 

4. If SET SPILL OFF is in effect (the default), characters that have been pushed 
beyond the truncation column are truncated. If SET SPILL ON or SET SPILL 
WORD has been issued, characters that have been pushed beyond the truncation 
column are inserted in the file as one or more new lines, starting with the first 
character or word that would have gone beyond the truncation column. 



1 (TOL) or Zone2 + 1 (EOL), no characters 



5. If the column pointer is at Zonel 
will be replaced. 



503E {TruncatedlSpilled} [RC = 3] 
545E Missing operand(s) [RC = 5] 
585E No hne(s) changed [RC = 4] 



Normal 

3 Truncated or spilled 

4 No line(s) changed 

5 Missing operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the rins 
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CREPLACE 



Examples 



Current Line: 



Shall I compare thee to a summer's day? 
I...+....1....+....2....+....3....+....4....+. 



cl /summer/ (move the column pointer) 
cr winter night? (blanks may be imbedded) 

===== Shall I compare thee to a winter night? 

<...+ 1 + 2 +.I..3 + 4 +, 
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CURSOR 



CURSOR 



Format 



Use the CURSOR subcommand to move the cursor to a specified position and to 
assign a priority to the specified position. The cursor is positioned according to the 
highest assigned priority when all pending prefix subcommands and any macros are 
executed or when the screen is redisplayed. 



CURsor 



CMdline [colno \1] [Priority n] 

Column [Priority n] 

File lineno [colno] [Priority w] 

Home [Priority n] 

Screen lineno [colno] [Priority «] 



Operands 



CMdline 

moves the cursor under the command Une in the specified column. 

Column 

moves the cursor under the current line in the current column position. 

File 

moves the cursor relative to the beginning of the file. 

Home 

moves the cursor fi:om the command Une to the screen or vice versa, depending 
on its current position. If the cursor is on the screen, that is, any place but on 
the command line, CURSOR HOME remembers its location and moves it to the 
command hne. If the cursor is on the command Hne, CURSOR HOME returns 
it to its previous location on the screen. 

Screen 

moves the cursor relative to the beginning of the logical screen. 

lineno 

specifies the file line (if used with the FILE operand) or the screen line (if used 
with the SCREEN operand) where the cursor is to be placed. 



colno 



specifies the column number where the cursor is to be placed. The location of 
colno varies according to the option with which it is specified: 

If used with CMDLINE, colno places the cursor relative to the beginning of the 
command line (after the arrow). 

If used with FILE, colno places the cursor relative to the beginning of a file line 
(after the prefix area). If not specified and the cursor is currently within the file 
area, it is placed in the same column number in the specified file Hne. 
Otherwise, the cursor is placed in the first column. 

If used with SCREEN, colno places the cursor relative to the beginning of the 
logical screen (under the first character of the prefix area). When colno is not 
specified for CURSOR SCREEN, the default cursor position is the current 
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Initial Setting 



Usage Notes 



CURSOR 



column in which it is displayed. If the cursor is on the command line, the colno 

is 7. 

Priority n 

is the priority number assigned. It must be greater than or equal to zero and 
less than 256. Higher numbers denote higher priorities and lower numbers 
denote lower priorities. If no priority is specified, all priorities of prefix 
subcommands and macros are ignored and the last CURSOR subcommand 
issued positions the cursor. 



*ENTER» key 
Change on the screen 



30 (initial setting for 'SET ENTER') 
20 



Refer to Chapter 4: "Prefix Subcommands and Macros" in this pubUcation for a 
complete list of the priorities for all prefix subcommands and macros. 



1. The CURSOR subcommand with the FILE or SCREEN operands is mainly 
intended to be issued from XEDIT macros. 

2. You can display the current cursor position, relative to the beginning of the file 
and the beginning of the screen, with the QUERY CURSOR subcommand (or, 
within a macro, you can use the EXTRACT subcommand). 

3. CURSOR HOME (and CURSOR COLUMN) are good candidates for PF key 
assignment. The initial setting of the PF12 key is CURSOR HOME. 

If CURSOR HOME is issued and the cursor cannot be returned to its previous 
position in the file (for example, if scrolling or splitting the screen removes that 
part of the file from the current screen), the cursor is positioned in the current 
column of the current line. However, if the cursor was located in an area other 
than the file area (like a reserved line) and CURSOR HOME is issued, the 
cursor returns to its position on the screen even if the screen is scrolled (provided 
a change to the screen layout does not make this impossible, for example, by 
splitting the screen). 

If the cursor is not on any logical screen, it moves to the command Une. 
HOME, at this point, is Une one, column one. 

4. If you issue CURSOR HOME immediately after entering XEDIT, the cursor 
will move to the current line and column if they are on the logical screen. If the 
current line and column are not on the screen, the cursor will move to the first 
verify column. 

5. If the cursor is in the prefix area when CURSOR HOME is issued, the cursor 
will move to the command line. If you issue CURSOR HOME again, the cursor 
will move to the first verify column within the Une adjacent to that prefix area. 

6. If the cursor is on a valid spot on the virtual screen, but that spot is not 
displayed on the physical screen, the cursor will be repositioned according to the 
rules in the VMISP CMS Command Reference for the CURSOR VSCREEN 
command. 
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CURSOR 



Notes For Macro Writers 

1 . The CURSOR subcommand does not scroll the screen. Therefore, when you use 
CURSOR FILE lineno, the line number (lineno) must appear on the current 
logical screen. For example, in the following subcommand, 

cursor file 700 

file line 700 must appear on the current logical screen. 

When you use CURSOR SCREEN lineno, the screen line (lineno) must be 
within your logical screen size. 

2. A macro can indicate where the cursor should be positioned as well as the 
priority for this cursor movement. As a result, when multiple prefix 
subcommands are issued and a macro is executed on the command line, the 
cursor is positioned at the location specified with the highest priority. 

Note: The cursor position is ONLY updated when a higher cursor priority is 
encountered. Therefore, if two prefix subcommands are specified that have the 
same cursor priority, the first one will determine the cursor placement. 
Likewise, if a prefix subcommand is issued and a macro is executed on the 
command line, both with equal cursor priorities, the prefix subcommand will 
determine the cursor placement. 

3. If multiple CURSOR subconmiands are issued, the priority of each is checked 
and the cursor position is updated to reflect the new setting, which corresponds 
to the command with the highest priority. The cursor remains in the screen it 
was in when the ENTER key is pressed; therefore, a CURSOR subcommand in 
another logical screen will have no effect on cursor placement. 



Messages 



520E Invalid operand: operand [RC = 5] 

52 IE Invahd line number [RC = 1 or 5] 

527E InvaUd column number [RC = 1] 

529E Subcommand is only vahd in {display|editing} mode [RC = 3] 

543E Invalid number: number [RC = 5] 

545E Missing operand(s) [RC = 5] 



Return Codes 



Normal 

Specified line (lineno) or column (colno) will set the cursor outside of the 

screen — no action taken 

Subcommand valid only for display terminal 

Invalid or missing operand or (line) number 

Subcommand rejected in the profile due to LOAD error, or QUIT 

subcommand has been issued in a macro called from the last file in the ring 
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DELETE 



Format 



DELETE 



Use the DELETE subcommand to delete one or more lines from a file, beginning 
with the current line. 




Operand 



Usage Note 



Responses 



target 

defines the number of hnes to be deleted. Deletion starts with the current line 
and continues up to, but does not include, the target Une. If you enter an 
asterisk (*), the rest of the file is deleted. If you omit target, only the current 
line is deleted. 

A target may be specified as an absolute Une number, a relative displacement 
from the current line, a Une name, or a string expression. For more information 
on targets, refer to the LOCATE subcommand in this book and to the 
pubhcation VM/SP System Product Editor User's Guide. 



1 . You can clear a line by pressing the spacebar once in column one and then 
pressing the ERASE EOF key (or repeatedly pressing the DELETE key). If a 
line is cleared in this manner, a blank line remains in the file. If you don't press 
the spacebar, the data will come back in the line the next time you press the 
ENTER key. This prevents you from erasing an entire line accidentally. 



If the operand is specified as any type of target other than a relative displacement 
target or if the Top of File or End of File Une is reached, the number of Unes deleted 
is displayed with the following message: 



5011 nn line(s) deleted 



On a forward DELETE (toward the end of the file) the Une immediately following 
the last line deleted becomes the new current line. 

On a backward DELETE (toward the top of the file), the Une preceding the last 
deleted Une becomes the new current Une. 

If you delete all lines in a file, the following message is displayed: 



559W Warning: file is empty 
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DELETE 



Messages 

520E Invalid operand: operand [RC = 5] 
546E Target not found [RC = 2] 

Return Codes 

Normal 

1 Partial delete due to TOP or EOF reached during execution 

2 Target line not found 

5 Invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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DELETE 



Examples 

Figure 7 is a before-and-after example of the DELETE subcommand. 



ANIMALS FACiS Al V ou irunc=bu bize=ifa Line=iy Loi=i Ait=u 

===== ACROSS WATER. 

===== OCTOPI HAVE LARGE BRAINS AND SHOW CONSIDERABLE CAPACITY FOR 

===== LEARNING. 

===== THE ARMADILLO IS THE ONLY ARMORED MAMMAL. 

===== THE LION ROARS TO ANNOUNCE POSSESSION OF A PROPERTY. 

===== THE KILLER WHALE EATS DOLPHINS, PORPOISES. SEALS. PENGUINS, AND 

===== SQUID. 

===== THE BOOKLOUSE CAN BE FOUND IN OLD BOOKS. IT FEEDS ON THE GLUE OF THE 

===== BINDINGS AND ON MOLDS THAT GROW ON OLD PAPER. 

===== ALTHOUGH PORCUPINE FISHES BLOW THEMSELVES UP AND ERECT THEIR SPINES, 

I... +,...!.... +....2.... +....3.... +....4.... +....5.... +..,.6.... +....7. 
===== THEY ARE SOMETIMES EATEN BY SHARKS. NO ONE KNOWS WHAT EFFECT THIS 
===== HAS ON THE SHARKS. 

===== A FISH CALLED THE NORTHERN SEA ROBIN MAKES NOISES LIKE A WET 
===== FINGER DRAWN ACROSS AN INFLATED BALLOON. 

===== STINGAREES, FISH FOUND IN AUSTRALIA, CAN WEIGH UP TO 800 POUNDS 
===== AND HAVE THE MOST POTENT VENOM OF ALL FISH. 

===== OSTRICHES CAN KICK LIKE A MULE, IMITATE A LION'S ROAR, AND HISS LIKE 
===== A SNAKE. 
===== A QUEEN ANT CAN LIVE UP TO 15 YEARS. 



delete /ROBIN/ 



X E D I T 1 File 



ANIMALS FACTS Al V 80 Trunc=80 Size=25 Line=19 Col=l Alt=l 
3 line(s) deleted 

= ACROSS WATER. 

===== OCTOPI HAVE LARGE BRAINS AND SHOW CONSIDERABLE CAPACITY FOR 

===== LEARNING. 

===== THE ARMADILLO IS THE ONLY ARMORED MAMMAL. 

===== THE LION ROARS TO ANNOUNCE POSSESSION OF A PROPERTY. 

===== THE KILLER WHALE EATS DOLPHINS. PORPOISES, SEALS. PENGUINS, AND 

===== SQUID. 

===== THE BOOKLOUSE CAN BE FOUND IN OLD BOOKS. IT FEEDS ON THE GLUE OF THE 

===== BINDINGS AND ON MOLDS THAT GROW ON OLD PAPER. 

===== A FISH CALLED THE NORTHERN SEA ROBIN MAKES NOISES LIKE A WET 

I...+....1....+....2....+....3....+....4....+....5....+....6....+....7, 
===== FINGER DRAWN ACROSS AN INFLATED BALLOON. 

===== STINGAREES, FISH FOUND IN AUSTRALIA, CAN WEIGH UP TO 800 POUNDS 
===== AND HAVE THE MOST POTENT VENOM OF ALL FISH. 

===== OSTRICHES CAN KICK LIKE A MULE, IMITATE A LION'S ROAR. AND HISS LIKE 
===== A SNAKE. 

===== A QUEEN ANT CAN LIVE UP TO 15 YEARS. 
===== * * * End of File * * * 



















X E D I 


T 1 File 



Figure 7. The DELETE Subcommand — Before and After 
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DOWN 



DOWN 



Format 



Operand 



Usage Note 



Response 
Messages 

Return Codes 



Example 



Use the DOWN subcommand to advance the Une pointer a specified number of Unes 
toward the end of the file. The Une pointed to becomes the new current line. (The 
DOWN subcommand is equivalent to the NEXT subcommand.) 




is the number of lines to move the Une pointer. If you specify an asterisk (*), 
the Une pointer moves to the "End of File" Une. If you omit n, the pointer 
moves down only one line. 



The Down n subcommand is equivalent to a plus ( + ) target definition. 

For example: 
down 3 

is equivalent to 
+3 



The Une pointed to becomes the new current Une. 



520E Invalid operand: operand [RC = 5] 
543E InvaUd number: number [RC = 5] 



Normal 

1 End of file reached and displayed 

5 Invalid operand or number 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 



Refer to the example of the NEXT subcommand. 
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DUPLICAT 



Format 



Use the DUPLICAT subcommand to duplicate one or more lines, starting with the 
current line, for a specified number of times. The new line(s) is inserted immediately 
after the original line(s). 



DUPlicat 




n 
1 


target 
1 


- 



Operands 



Response 
Messages 



Return Codes 



specifies the number of times that the Une(s) is to be duplicated. If you omit n, 
the current line is duplicated once. 

target 

defines the number of hnes to be duplicated. DupUcation starts with the current 
Une and continues up to but does not include the target Une. If you omit target, 
only the current line is duplicated. 

A target may be specified as an absolute line number, a relative displacement 
from the current line, a line name, or a string expression. For more information 
on targets, refer to the LOCATE subcommand in this book and to the 
publication VM/SP System Product Editor User's Guide. 



The last line duplicated becomes the new current line. 



520E Invahd operand: operand [RC = 5] 

543E Invalid number: number [RC = 5] 

546E Target not found [RC = 2] 

557S No more storage to insert hnes [RC = 4] 



Normal 

1 TOF or EOF reached 

2 Target hne not found 

4 No more storage to continue duplicating 

5 Invahd operand or number 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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EMSG 



The EMSG subcommand has two formats. Use the first format to display a 
message at the terminal and to sound the alarm. Use the second format in macros 
and modules that interface with XEDIT and whose messages follow the rules for 
VM/SP messages (see the VM/SP System Messages and Codes book). The severity 
of the message determines whether or not the alarm is sounded. 



Format 



EMSG 



[tex!^] 



\mmmnnn 



[n]s] 



Operands 



text 



is the text of the message to be displayed. If no text is specified, a blank Une 
will be displayed. 

mmmnnnfnjs 

is the message identification. 



mmm 



are three letters indicating which macro or module generated the message. 

nnn[n] 

is the three-digit or four-digit message number. It may be used to find 
additional information in the VM/SP System Messages and Codes book. 



indicates the severity and is one of the following: 



R - response 
I - information 
W - warning 



E - error 

S - severe error 

T - terminal (unrecoverable) error 



With a severity of R, I, or W, the alarm is not sounded. With a severity of E, S, or 
T, the alarm is sounded when the message is displayed. 

The message is prefixed by "DMS" before being displayed. 



Usage Notes 



1 . The SOS ALARM subcommand may be used to sound the alarm without 
displaying any message. 

2. Messages are displayed according to the SET MSGMODE setting (ON or OFF). 

3. When using the second format, the message identification is processed according 
to the CP EMSG setting (see the VM/SP CP General User Command Reference). 
In addition, the message is processed according to the SET MSGMODE setting 
(LONG or SHORT). 

4. The message identification (mmmnnns) must not contain imbedded blanks. It 
must be preceded by only one blank deUmiter. 
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Response 
Return Codes 



5. EMSG can also be used to display messages on a typewriter terminal. 



The message is displayed in the message area of the logical screen. 



Normal 

5 Invahd operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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EXPAND 



Format 



Use the EXPAND subcommand to reposition data in one or more file lines that 
contain tab characters (X'05'), according to the current tab settings (defined by a 
SET TABS subcommand). Each time a tab character appears in a line, the editor 
repositions the data in the column defined by the SET TABS subcommand. 




Operand 



Usage Notes 



Responses 



target 



defines the number of lines to be expanded. Lines are expanded starting with 
the current line and continuing up to, but not including, the target Une. If you 
enter an asterisk (*), the rest of the file is expanded. If you omit target, only the 
current line is expanded. 

A target may be specified as an absolute line number, a relative displacement 
from the current Hne, a line name, or a string expression. For more information 
on targets, refer to the LOCATE subcommand in this book and to the 
publication VM/SP System Product Editor User's Guide. 



1 . In order for EXPAND to work properly, lines containing backspace characters 
(X' 16') must have been entered into the file with SET IMAGE CANON in 
effect, that is, compound characters ordered with backspaces arranged singly 
between the characters that overlay each other. 

2. Refer to the COMPRESS subcommand description for an explanation of how to 
use the COMPRESS, EXPAND, and SET TABS subcommands to reposition 
data. 

3. If SET SPILL OFF is in effect (the default), characters that have been pushed 
beyond the truncation column are truncated. If SET SPILL ON or SET SPILL 
WORD has been issued, characters that have been pushed beyond the truncation 
column are inserted in the file as one or more new lines, starting with the first 
character or word that would have gone beyond the truncation column. 



If you specify that an EXPAND is to occur on multiple lines and it does occur, the 
current line pointer will be: 

a. Unchanged if SET STAY ON has been issued 

b. Moved to the last line expanded, if SET STAY OFF is in effect (the 
default). 
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Messages 



Return Codes 



504E m line(s) {truncated|spiiled} [RC = 3] 

520E Invalid operand: operand [RC = 5] 

546E Target not found [RC = 2] 

58 IE Subcommand is not valid in extended mode [RC = 3] 

585E No line(s) changed [RC = 1 or 4] 



Normal 

1 TOP or EOF reached during execution 

2 Target line not found 

3 Truncated or spilled, or subcommand is not valid in extended mode 

4 No line(s) changed 

5 Invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 



Examples 



See the "Examples" section of the COMPRESS subcommand. 
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EXTRACT 



Format 



Operands 



Use the EXTRACT subcommand within a macro to get information about internal 
XEDIT variables or about file data. XEDIT returns the information in one or more 
variables, which can then be used or examined by the macro. Operands of the 
EXTRACT subcommand are separated by a self-defining deUmiter in the same 
fashion that string targets or operands are delimited. 




/(diagonal) 

signifies any delimiting character that does not appear in the "operand" string(s). 

operand 

may be any one of the keywords listed below. 



ACT ion 


FLscreen 


NULls 


TABLine 


ALT 


FMode 


NUMber 


TABS 


APL 


FName 


PA [nl*] 


TARGet 


ARBchar 


FType 


PACK 


TERMinal 


AUtosave 


FULLread 


PENDing (below) 


TEXT 


BASEft 


HEX 


PF [n|*] 


TOF 


BRKkey 


IMage 


Point [*] 


TOFEOF 


CASE 


IMPcmscp 


PREfix (below) 


TOL 


CMDline 


INPmode 


RANge 


TRANS Lat 


COLOR fieldl* 


LASTLorc 


RECFm 


TRunc 


COLPtr 


LASTmsg 


REMOte 


UNIQueid 


COLumn 


LENgth 


RESERved [*] 


UNTil 


CTLchar [char] 


LIBName 


RING 


UPDate 


CURLine 


LIBType 


SCALe 


VARblank 


CURSor 


Line 


SCOPE 


Veri fy 


Display 


LINENd 


SCReen 


VERShift 


EOIRName 


LOCk 


SELect 


Width 


EFMode 


LRecl 


SeqS 


WINdow 


EFName 


LScreen 


SERial 


WRap 


EFType 


MACRO 


SHADOW 


Zone 


ENTer 


MASK 


SIDcode 


= 


EOF 


MEMber 


Size 




EOL 


MSGLine 


SPAN 




Escape 


MSGMode 


SPILL 




ETARBCH 


NBFile 


STAY 




ETMOOE 


NBScope 


STReam 




FILler 


NONDisp 


SYNonym [namel*] 



PENDing [BLOCK] [OLDNAME] namel* [targetl[target2]] 
PREfix [Synonym nl Synonym *] 

The following is a hst of the values returned by EXTRACT for each of the settings. 
The variables are returned in the form "name.n" where "name" is the full name of 
the variable requested and "n" is a subscript that distinguishes the different values 
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returned. An exception occurs in the case of = . Variables are returned as 
"EQUALSIGN.", followed by the number. In all cases the value of "name.O" is the 
number of variables returned for that setting. EXEC 2 variables that are returned 
are preceded by an ampersand (&). 

ACTion 

returns "ON" or "OFF" to indicate whether any action other than displaying or 
scrolling has been taken on this file. This includes any file ID change, or file 
characteristic change (LRECL, RECFM, PACK, SERIAL, SIDCODE, or 
ALT), as well as any other changes made to the file. 

ACTION. number of variables returned 

.1 ONtOFF 

ALT 

returns the number of alterations that have been made to the file since the last 
AUTOSAVE and SAVE, or as specified in the SET ALT subcommand. 

ALT.0 number of variables returned 

.1 number of changes since last AUTOSAVE 

.2 number of changes since last SAVE 

APL 

returns "ON" or "OFF" as defined by the SET APL subcommand. 

APL.0 number of variables returned 

.1 ONIOFF 

ARBchar 

returns "ON" or "OFF" and the arbitrary character specified in the SET 
ARBCHAR subcommand. 

ARBCHAR. number of variables returned 

.1 ONIOFF 

.2 arbitrary character 

AUtosave 

returns the current setting defined in the SET AUTOSAVE subcommand: the 
AUTOSAVE count, file ID, the number of alterations, and the disk or directory 
on which the autosave file is written. 

AUTOSAVE. number of variables returned 

.1 OFF or autosave count 

.2 autosave file name 

.3 number of alterations since last 

autosave 
.4 autosave file mode (one character) 

BASEft 

returns the base file type specified in the LOAD subcommand or the XEDIT 
command (where the LOAD is implicit). 

BASEFT. number of variables returned 

.1 file type specified in the LOAD 

subcommand or the XEDIT command 
(where the LOAD is implicit) 
when XEDIT is invoked 
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BRKkey 

returns "ON" or "OFF" as defined by the CP terminal brkkey setting. If ON, 
then also returns the key. 

BRKKEY. number of variables returned 

.1 ONjOFF 

.2 PAnlPFn 

CASE 

returns the case setting as defined in the SET CASE subcommand. 

CASE.0 number of variables returned 

.1 MIXED I UPPER 

.2 RESPECT I IGNORE 

CMDIine 

returns "ON", "OFF", "TOP", or "BOTTOM" as specified in the SET 
CMDLINE subcommand and the Une number designated as the command line 
on the screen. CMDLINE.2 is not returned when CMDLINE. 1 = OFF. 

CMDLINE. number of variables returned 

.1 ON I OFF I TOP I BOTTOM 

.2 line number on screen 

COLOR fieldj* 
COLOR field 

returns area of screen and its respective color, extended highlighting, 
highlighting, and programmed symbol set options as specified in the SET 
COLOR subcommand. The field may be specified as: Arrow, Cmdline, 
CUrline, Filearea, Idline, Msgline, Pending, PRefix, Scale, SHadow, STatarea, 
Tabline, TOfeof 

COLOR. number of variables returned 

.1 color 

.2 extended highlighting 

.3 HIGHINOHIGH 

.4 programmed symbol set 

COLOR * 

returns the areas of the screen and their respective colors, extended highUghting, 
highUghting, and programmed symbol set options as they have been specified in 
the SET COLOR subcommand. 



COLOR. 


number of 


variat 


)les r< 


^turned 


.1 


ARROW 


color 


exthi 


HIGHINOHIGH PSs 


.2 


CMDLINE 


color 


exthi 


HIGHINOHIGH PSs 


.3 


CURLINE 


color 


exthi 


HIGHINOHIGH PSs 


.4 


FILEAREA 


color 


exthi 


HIGHINOHIGH PSs 


.5 


IDLINE 


color 


exthi 


HIGHINOHIGH PSs 


.6 


MSGLINE 


color 


exthi 


HIGHINOHIGH PSs 


.7 


PENDING 


color 


exthi 


HIGHINOHIGH PSs 


.8 


PREFIX 


color 


exthi 


HIGHINOHIGH PSs 


.9 


SCALE 


color 


exthi 


HIGHINOHIGH PSs 


.10 


SHADOW 


color 


exthi 


HIGHINOHIGH PSs 


.11 


STATAREA 


color 


exthi 


HIGHINOHIGH PSs 


.12 


TABLINE 


color 


exthi 


HIGHINOHIGH PSs 


.13 


TOFEOF 


color 


exthi 


HIGHINOHIGH PSs 



COLPtr 

returns "ON" or "OFF" as defined by the SET COLPTR subcommand. 

COLPTR. number of variables returned 

.1 ONIOFF 
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COLumn 

returns the column number of the column pointer. 

COLUMN. number of variables returned 

.1 current column number 

CTLchar (char) 
CTLchar char 

returns whether or not "char" is in a protected status and the color, extended 
highlighting, highlighting, and programmed symbol set associated with "char" as 
specified by the SET CTLCHAR subcommand. When "char" is specified and 
CTLCHAR. 1 = OFF, then CTLCHAR.2 through CTLCHAR.5 are not 
returned. If SET CTLCHAR is not OFF (there are control characters defined) 
and just this particular character is not defined, then CTLCHAR.O will be and 
no other variables will be returned. 



CTLCHAR.O 


number of variables returned 


.1 


PROTECT INOPROTECTI OFF 




(OFF means no "chars" defini 


.2 


color 


.3 


extended highlighting 


.4 


HIGHINOHIGHI INVISIBLE 


.5 


programmed symbol set 



CTLchar 

returns the escape character and all control characters, if any, defined by the 
SET CTLCHAR subcommand. If CTLCHAR. I = "OFF", then CTLCHAR.2 
and CTLCHAR. 3 are not returned. 

CTLCHAR.O number of variables returned 

.1 ONIOFF 

.2 escape character 

.3 list of control characters (if any) 

CURLine 

If you are using a display terminal, EXTRACT /CURLINE/ returns the line 
number of the current line as specified by the SET CURLINE subcommand, the 
contents of the current line from column one through the truncation column 
(excluding traiUng blanks), and whether or not it has been changed or inserted 
during this editing session. 

CURLINE. number of variables returned 

.1 M [+n|-n] I [-] n (M = middle 

of screen) 
.2 actual line number on screen 

.3 contents of current line (or null if 

line pointer at TOF or EOF line) 
.4 ONIOFF (ON if CURLINE has been changed 

or inserted in this editing session) 
.5 OLD 1 OLD CHANGED I NEW I NEW CHANGED 

(OLD if CURLINE not inserted this 
session, NEW if CURLINE inserted 
this session, and CHANGED if 
CURLINE changed during this 
session) 

If you are using a typewriter terminal, EXTRACT /CURLINE/ returns the 
contents of the current line from column one through the truncation column 
(excluding traihng blanks), and whether or not it has been changed or inserted 
during this editing session. 
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CURLINE.0 number of variables returned 
.1 -1 
.2 -1 
.3 contents of current line 

(or null if line pointer at 
TOP or EOF line) 
.4 ON I OFF (ON if CURLINE has been changed 

or inserted in this editing session) 
.5 OLD I OLD CHANGED I NEW I NEW CHANGED 

(OLD if CURLINE not inserted this 
session, NEW if CURLINE inserted 
this session, and CHANGED if 
CURLINE changed during this 
session) 

CURSor 

returns the current and the original position of the cursor on the screen (line 
number and column number), the current and the original position of the cursor 
in the file (line number and column number), and the priority number (if 
assigned) as specified in the CURSOR subcommand. The current position is the 
position where the cursor would be placed if the screen were displayed at this 
time. The current position reflects relative changes due to additions/deletions of 
lines resulting from prefix execution. It does not necessarily reflect where the 
cursor will eventually be located when the screen is actually displayed. This is 
because cursor priority cannot be resolved until the screen is displayed. The 
original position is the position of the cursor when the screen was read, which 
has been updated with changes due to the execution of prefix subcommands and 
macros. If the cursor is not in the file, then CURSOR.3 and CURSOR.4 = -l. 
Likewise, if the cursor was not originally in the file, then CURSOR.? and 
CURSOR.8 = -1. However, if the screen had not been displayed, then 
CURSOR.? and CURSOR.8 = 0. This can occur if EXTRACT/CURSOR/ is 
issued from the profile macro. 



CURSOR. 
.1 
.2 
.3 
.4 
.5 



.6 



,7 



.8 



.9 



number of variables returned 
position of cursor on screen (line number) 
position of cursor on screen (col. number) 
position of cursor in file (line number) 
position of cursor in file (col. number) 
original .l--original position of the 

cursor on the screen 

(line number) 
original .2--original position of the 

cursor on the screen 

(column number) 
original .3--original position of the 

cursor in the file 

(line number) 
original .4--original position of the 

cursor in the file 

(column number) 
highest priority or zero 



Display 

returns the range of selection levels which are included in the display, as 
specified by the SET DISPLAY subcommand. 

DISPLAY. number of variables returned 

.1 start of display range 

.2 end of display range 
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EDIRName 

returns the name of the SFS directory containing the file at the time the file was 
first loaded. 

EDIRNAME. number of variables returned 

.1 entry directory name (directory name when the 
XEOIT environment is entered), or null for a 
minidisk file. 

EFMode 

returns the two-character file mode of the file at the time the file was first 
loaded. 

EFMODE. number of variables returned 

.1 entry file mode (file mode when the XEDIT 
environment is entered) 

EFName 

returns the eight-character file name of the file at the time the file was first 
loaded. 

EFNAME. number of variables returned 

.1 entry file name (file name when the XEDIT 
environment is entered) 

EFType 

returns the eight-character file type of the file at the time the file was first 
loaded. 

EFTYPE. number of variables returned 

.1 entry file type (file type when the XEDIT 
environment is entered) 

ENTer 

returns "BEFORE", "AFTER", "ONLY", or "IGNORE" and the ENTER key 
definition as specified by the SET ENTER subcommand. If the ENTER key is 
undefined, then ENTER.0 = and no other variables are returned. 

ENTER. number of variables returned 
.1 BEFORE I AFTER 1 ONLY I IGN0RE 
.2 ENTER key definition 

EOF 

returns "ON" or "OFF" as determined by the editor. EOF is "ON" when the 
Une pointer reaches the End of File (or End of Range) Une. 

EOF.0 number of variables returned 
.1 ONIOFF 

EOL 

returns "ON" or "OFF" as determined by the editor. EOL is "ON" when the 
column pointer reaches zone2 + 1. 

EOL.0 number of variables returned 
.1 ONIOFF 

ESCape 

returns "ON" or "OFF" and the escape character defined by the SET ESCAPE 
subcommand. 

ESCAPE. number of variables returned 
.1 ONIOFF 
.2 escape character 
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ETARBCH 

returns "ON" or "OFF" and the extended arbitrary character specified in the 
SET ETARBCH subcommand. 

ETARBCH. number of variables returned 
.1 ONIOFF 
.2 extended arbitrary character enclosed 

by a shift-out and a shift-in character 

ETMODE 

returns "ON" or "OFF" as specified by the SET ETMODE subcommand. 

ETMODE. number of variables returned 
.1 ONIOFF 

FILler 

returns the filler character defined by the SET FILLER subcommand. 

FILLER. number of variables returned 

.1 filler character 

FLscreen 

returns the line numbers of the first and last lines of the file displayed on the 
screen. 

FLSCREEN. number of variables returned 

.1 line number of the first line of the file 

displayed on the screen 
.2 line number of the last line of the file 

displayed on the screen 

FMode 

returns the two-character file mode. 

FMODE. number of variables returned 

.1 file mode 

FName 

returns the eight-character file name. 

FNAME. number of variables returned 

.1 file name 

FType 

returns the eight-character file type. 

FTYPE. number of variables returned 

.1 file type 

FULLread 

returns "ON" or "OFF" as specified by the SET FULLREAD subcommand. 

FULLREAD. number of variables returned 
.1 ONIOFF 

HEX 

returns "ON" or "OFF" as specified in the SET HEX subcommand. 

HEX.0 number of variables returned 
.1 ONIOFF 

IMage 

returns "ON", "OFF", or "CANON" as specified in the SET IMAGE 

subcommand. 

IMAGE. number of variables returned 

.1 ON I OFF I CANON 
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IMPcmscp 

returns "ON" or "OFF" as specified in the SET IMPCMSCP subcommand. 

IMPCMSCP. number of variables returned 

.1 ONIOFF 

INPmode 

returns "ON" or "OFF" as determined by whether or not you are in input 
mode. 

INPMODE. number of variables returned 

.1 ONIOFF 

LASTLorc 

returns the current contents of the last locate or change buffer, as specified either 
by SET LASTLORC or by the editor. 

LASTLORC. number of variables returned 

.1 contents of LASTLORC buffer or null 

LASTmsg 

returns the last message that was issued by the editor. (Depending on the SET 
MSGMODE operands specified, this message may or may not have been 
displayed.) If CP SET EMSG OFF is in effect, LASTMSG is not updated, even 
if SET MSGMODE ON. 

LASTMSG. number of variables returned 

.1 last message issued or null 

LENgth 

returns the length of the current line from column one through the truncation 
column (excluding trailing blanks). 

LENGTH. number of variables returned 

.1 length of current line (Length 

of TOF and EOF lines is zero.) 

LIBName 

returns the library file name while editing a member of a CMS library. 

LIBNAME. number of variables returned 

.1 library file name or blanks (if not 

editing a member of a library) 

LIBType 

returns the library file type while editing a member of a CMS library. 

LIBTYPE. number of variables returned 

.1 library file type or blanks (if not 

editing a member of a library) 

Line 

returns the current line number, relative to the beginning of the file 

LINE.O number of variables returned 

.1 line number (in the file) of current 

line 

LINENd 

returns "ON" or "OFF" and the line end character as defined by the SET 
LINEND subcommand. 

LINEND. number of variables returned 

.1 ONIOFF 

.2 linend character 
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LOCk 

returns "ON" or "OFF" to indicate whether the file was locked by the editor at 
the time it was first loaded. "ON" will be returned even if the lock has since 
been dropped by the file system. 

LOCK.O number of variables returned 

.1 ONlOFF 

LRecI 

returns the logical record length of the file. 

LRECL.O number of variables returned 

.1 Irecl of file 

LScreen 

returns six integers—the number of Unes and the number of columns in the 
logical screen, the line number and the column number defining the top left 
corner of the logical screen on the virtual screen, and the number of lines and 
the number of columns of the virtual screen. 

LSCREEN. number of variables returned 

.1 number of lines on logical screen 

.2 number of columns on logical screen 

.3 line number of top left of logical screen 

.4 column number of top left of logical 

screen 

.5 number of lines in virtual screen 

.6 number of columns in virtual screen 

MACRO 

returns "ON" or "OFF" as specified by the SET MACRO subcommand. 

MACRO. number of variables returned 

.1 ONlOFF 

MASK 

returns the current mask line as defined by the SET MASK subcommand. 

MASK.0 number of variables returned 

.1 mask definition 

MEMber 

returns "ON" if you are editing a member of a CMS Ubrary (the MEMBER 
option was specified when you entered XEDIT) or "OFF" if you are not editing 
a member of a CMS Ubrary. 

MEMBER. number of variables returned 

.1 ONlOFF 

MSGLine 

returns "ON" or "OFF", the location of the message line, the number of lines 
the message line can expand to, and OVERLAY, if specified, as defined by the 
SET MSGLINE subcommand. If MSGLINE. 1 = OFF, then MSGLINE.2 
through MSGLINE.4 are not returned. 

MSGLINE. number of variables returned 

.1 ONlOFF 

.2 M [+nl-n] j [-] n 

(M = middle of screen) 
.3 number of lines the message line can 

expand to for displaying a message 
.4 OVERLAY or nulls 
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MSGMode 

returns "ON" or "OFF", and "LONG" or "SHORT" as defined by the SET 
MSGMODE subcommand. 

MSGMODE. number of variables returned 

.1 ONIOFF 

.2 LONG I SHORT 

NBFile 

returns the number of files you are currently editing. 

NBFILE. number of variables returned 

.1 number of files in XEDIT ring 

NBScope 

returns the number of lines in the file within the current scope setting and the 
position of the current Une within that number. If SCOPE is set to ALL, then 
the size of the file and the number of the current line is returned. If SCOPE is 
DISPLAY, then the number of hues that fall within the defined DISPLAY level 
and the count of the current line within this set of lines is returned. If the Top 
of File Hne is the current Une, NBSCOPE.2 = 0. If the End of File Une is the 
current line, NBSCOPE.2 = NBSCOPE. 1 + 1 . 

NBSCOPE. number of variables returned 

.1 number of lines within the current 

scope 
.2 position of the current line within 

the scope 

NONDisp 

returns the character defined by the SET NONDISP subcommand. 

NONDISP. number of variables returned 

.1 nondisp character 

NULIs 

returns "ON" or "OFF" as specified by the SET NULLS subcommand. 

NULLS. number of variables returned 

.1 ONIOFF 

NUMber 

returns "ON" or "OFF" as specified by the SET NUMBER subcommand. 

NUMBER. number of variables returned 

.1 ONIOFF 

PA [n|*l 
PAn 

returns "BEFORE", "AFTER", "ONLY", or "IGNORE" and the PAn key 

definition as specified by the SET PAn subcommand. If the PAn key is 
undefined, then PAn.O = and no other variables are returned. 

PAn.O number of variables returned 
PAn.l BEFORElAFTERjONLY I IGNORE 
PAn. 2 PAn key definition 
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PA[*I 

returns "BEFORE", "AFTER", "ONLY", or "IGNORE" and the PAn key 
definition as specified in the SET PAn subcommands for all of the PA keys. If 
any PA key is undefined, then PAn.O = and no other variables are returned for 
that PA key. 

PA1.0 number of variables returned for PAl 

PAl.l BEFORE I AFTER 1 ONLY I IGNORE 

PAl. 2 PAl key definition 

PA2.0 number of variables returned for PA2 

PA2.1 BEFORE 1 AFTER I ONLY I IGNORE 

PA2.2 PA2 key definition 

PA3.0 number of variables returned for PAS 

PA3.1 BEFORE I AFTER I ONLY I IGNORE 

PA3.2 PA3 key definition 

PACK 

returns "ON" or "OFF" as specified by the SET PACK subcommand. 

PACK.0 number of variables returned 

.1 ONIOFF 

PENDing [BLOCKJ [OLDNAMEl name\* [target l{target2\\ 

f a 1 *ll 

returns information from the "pending list" (see SET PENDING in this 
publication) with respect to a particular subcommand or macro name or the first 
pending entry. 

BLOCK 

indicates that the pending list is to be checked for BLOCK entries only and will 
return the word "BLOCK" if one is found. "BLOCK" will also be returned if a 
block entry is the one found regardless of whether BLOCK was specified. 

OLDNAME 

indicates that the name specified is the original name of the prefix subcommand 
or macro. 

name 

indicates the name of the prefix subcommand or macro for which you are 
searching. If OLDNAME is also specified, name must be the original name of 
the prefix subcommand or macro, regardless of whether or not a synonym has 
been assigned to that name. Otherwise, it is assumed to be a synonym (that is, a 
new name) or a name without a synonym. 



indicates to return the first entry in the pending list. If BLOCK is also specified, 
* indicates to return the first block entry. 

targetl target2 

indicates the range in the file where the associated prefix subcommand or macro 
must be located. If only targetl is specified, the search will be conducted 
starting at targetl and will run to the end of the file. Targetl will be obtained 
relative to the top of the file. For example, EXTRACT /PENDING * +3 / will 
start at the top of the file and go 3 lines forward in the file to begin the search. 
Target2 will be obtained relative to targetl. If targetl is line 3 and you enter a 
+ 5 as target2, then the search will be from line 3 through line 8, inclusive of 
both target hnes. If target2 is specified prior to targetl, the result will be the 
same as if you had specified targetl target2. For example, EXTRACT 
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/PENDING * :10 :2/ will produce the same results as EXTRACT /PENDING * 
:2 :10/. If no targets are specified, the entire pending list is searched, that is, the 
entire file is searched, starting from the top of the file (:!). 

If no pending entry is found, then PENDING.O = and no other variables are 
returned. If a target is specified and is not found, the return code from 
EXTRACT will be "2". 

PENDING.O number of variables returned 

.1 line number in the file 

.2 newname--the name entered in the prefix 

area 
.3 oldname--the original name of the prefix 

subcommand or macro, after 
synonym resolution 
.4 BLOCK I null— BLOCK is returned if a prefix 

block entry is located in the 
pending list; otherwise, 
nulls are returned. 
.5 opl|null--the first operand accompanying 

the subject prefix subcommand 
or macro 
.6 op21 null --the second operand accompanying 

the subject prefix subcommand 
or macro 
.7 op3l null --the third operand accompanying 

the subject prefix subcommand 
or macro 

PF (ni*l 
FFn 

returns "BEFORE", "AFTER", "ONLY", or "IGNORE" and the PFn key 
definition as specified in the SET PFn subcommand. If the PFn key is 
undefined, then PFn.O = and no other variables are returned. 

PFn.O number of variables returned 

PFn.l BEFORE I AFTER I ONLY I IGNORE 

PFn. 2 PFn key definition 

PF[*1 

returns "BEFORE", "AFTER", "ONLY", or "IGNORE" and the PFn key 
definition as specified by the SET PFn subcommands for all of the PF keys. If 
any PF key is undefined, then PFn.O = and no other variables are returned for 
that PF key. 



PF1.0 


number of variables returned 




for PFl 


PFl.l 


BEFORE 1 AFTER! ONLY IIGNORE 


PF1.2 


PFl key definition 


PF2.0 


number of variables returned 




for PF2 


PF2.1 


BEFORE 1 AFTER 1 ONLY IIGNORE 


PF2.2 


PF2 key definition 



PF24.0 number of variables returned 

for PF24 
PF24.1 BEFORE I AFTERl ONLY IIGNORE 

PF24.2 PF24 key definition 
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Point 1*1 
Point 

returns the symbolic name(s) associated with the current line. If no names have 
been assigned to the current Une, then POINT.O = and POINT. 1 is not 
returned. 

POINT. G number of variables returned 

.1 line number and up to the last 100 

names assigned to the current line 

Point * 

returns all symbohc names that have been defined, starting at the top of the file. 
If no names are defined, then POINT.O = and no other variables are returned. 

POINT.O number of variables returned 

.1 line number and all names on 

first named line 
.2 line number and all names on 

second named line 



POINT. n line number and all names on 

nth named line 

PREfix [Synonym name\Synonym *] 

PREfix 

returns "ON", "OFF", or "NULLS" and "RIGHT" or "LEFT" as specified in 
the SET PREFIX subcommand. 

PREFIX. number of variables returned 

.1 ON I OFF I NULLS 

.2 RIGHTlLEFT 

PREfix Synonym name 

returns the original name associated with the prefix subcommand or macro, 
before synonym resolution. If "name" is not in the prefix synonym table, then 
oidname = name. 

PREFIX. number of variables returned 

.1 oidname 

PREfix Synonym * 

returns both the old and the new names of the synonyms defined for the prefix 
subcommand(s) or macro(s). 

PREFIX. number of variables returned 

.1 newname oidname 



PREFIX. n newname oidname 

RANge 

returns the line numbers of the top and bottom of the range defined by the SET 
RANGE subcommand. 

RANGE. number of variables returned 

.1 line number of the first line 

in range 
.2 line number of the last line 

in range 
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RECFm 

returns the record format, "F", "V", "FP", or "VP", defined by the SET 
RECFM subcommand. 

RECFM. number of variables returned 

.1 record format of file 

REMOte 

returns "ON" or "OFF" depending upon whether or not a remote terminal is 
being used or upon the setting defined by the SET REMOTE subcommand. 

REMOTE. number of variables returned 

.1 ONIOFF 

RESERved [*\ 
RESERved 

returns a list of line numbers of screen lines currently reserved. If no 
RESERVED Unes have been defined, then RESERVED.O = and no other 
variables are returned. 

RESERVED. number of variables returned 
.1 list of reserved line numbers 

RESERved * 

returns the line numbers of the screen lines currently reserved and the colors, 
extended highlighting, programmed symbol set, highlighting, and text associated 
with those reserved lines as specified by the SET RESERVED subcommand. If 
no RESERVED Unes have been defined, then RESERVED.O = and no other 
variables are returned. 

RESERVED. number of variables returned 

.1 linenum color exthi PSs HIGHlNOHIGH text 

.2 linenum color exthi PSs HIGH NOHIGH text 



.n linenum color exthi PSs HIGH | NOHIGH text 

RING 

returns the number of files you are editing and the file identification Une for 
each file. 

RING.O number of variables returned 

.1 number of files in the ring 

.2 file identification line of the 

first file 
.3 file identification line of the 

second file 



.n file identification line of the 

nth-1 file 
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SCALe 

returns "ON" or "OFF" and the position of the SCALE as specified by the SET 
SCALE subcommand (or SCALE prefix subcommand) and the line number of 
the scale on the screen. If SCALE is "OFF," only SCALE.O, SCALE. 1, and 
SCALE. 2 are returned. 

SCALE.O number of variables returned 

.1 ONIOFF 

.2 M [+n|-n] | [-] n 

(M = middle of screen) 
.3 line number on screen 

SCOPE 

returns "DISPLAY" or "ALL" as specified by the SET SCOPE subcommand. 

SCOPE. number of variables returned 

.1 ALL I DISPLAY 

SCReen 

returns the attributes of the screens that have been defined by the SET SCREEN 
subcommand. 

SCREEN. number of variables returned 

.1 SIZE|WIDTH|DEFINE screen definition 

SELect 

returns the selection level of the current line and the maximum selection level for 
the file as specified by the SET SELECT subcommand. 

SELECT. number of variables returned 

.1 selection level of current line 

.2 maximum selection level in the file 

Seq8 

returns "OFF" if the XEDIT command or LOAD subcommand was issued with 
the NOSEQ8 operand; if not, returns "ON". 

SEQ8.0 number of variables returned 

.1 ONIOFF 

SERial 

returns the serial identification, the increment value, and the serial number 
starting value as defined by the SET SERIAL subcommand. 

SERIAL. number of variables returned 

.1 serial or OFF 

.2 increment 

.3 start number 

SHADOW 

returns "ON" or "OFF" as specified by the SET SHADOW subcommand. 

SHADOW. number of variables returned 

.1 ONIOFF 

SIDcode 

returns the eight-character string specified in the SIDCODE option of the 
XEDIT command, the LOAD subcommand, or the SET SIDCODE 

subcommand. 

SIDCODE. number of variables returned 

.1 eight-character sidcode 

string(if specified) or blanks 
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SIZe 

returns the number of records in the file being edited. 

SIZE.0 number of variables returned 

.1 number of records in file 

SPAN 

returns "ON" or "OFF", "BLANK" or "NOBLANK", and n as defined in the 
SET SPAN subcommand. 

SPAN.O number of variables returned 

.1 ONIOFF 

.2 BLANK I NOBLANK 

.3 n--number of consecutive file lines 

that a character string can span 

SPILL 

returns "ON", "OFF", or "WORD" as defined by the SET SPILL 
subcommand. 

SPILL. number of variables returned 

.1 ON I OFF I WORD 

STAY 

returns "ON" or "OFF" as specified in the SET STAY subcommand. 

STAY.O number of variables returned 

.1 ONIOFF 

STReam 

returns "ON" or "OFF" as specified in the SET STREAM subcommand. 

STREAM.© number of variables returned 

.1 ONIOFF 

SYNonym 

returns "ON" or "OFF" as specified in the SET SYNONYM subcommand. 

SYNONYM. number of variables returned 

.1 ONIOFF 

SYNonym name\* 

SYNonym name 

returns the synonym, its minimum abbreviation (returned as the number of 
letters in the minimum abbreviation), the associated synonym definition, and the 
linend character, if it has been specified. If no synonym is defined, then 
SYNONYM. 1 and SYNONYM. 3 are set equal to the name of the synonym, 
SYNONYM.2 is set to the length of the name and SYNONYM.4 is set to null. 

SYNONYM. number of variables returned 

. 1 name 

.2 length of minimum abbreviation 

.3 definition 

.4 linend character (if specified) or null 
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SYNonym * 

returns for each defined synonym its name, its minimum abbreviation (returned 
as the number of letters in the minimum abbreviation), and the associated 
synonym definition (that is, everything that was specified in the SET 
SYNONYM subcommand). 

SYNONYM. number of variables returned 

.1 name abbrev. [LINEND char] 

definition 
.2 name abbrev. [LINEND char] 

definition 



.n name abbrev. [LINEND char] 

definition 

TABLine 

returns "ON" or "OFF", and the position of the TABLINE as specified by the 
SET TABLINE subcommand (or TABL prefix subcommand) and the Une 
number of the tabUne on the screen. If TABLINE is "OFF", only TABLINE.O 
and TABLINE. 1 are returned. 

TABLINE.O number of variables returned 

.1 ONIOFF 

.2 M [+n|-n] | [-] n 

.3 line number on screen 

TABS 

returns the tab column numbers defined by the SET TABS subcommand. 

TABS.0 number of variables returned 

.1 tab columns 

TARGet 

returns the following information about the character string that matches the 
last target located via a LOCATE or CLOCATE: line and column number of 
the first character in the string, and line and column number of the last 
character in the string. 

returns the following information about targets that have been specified as an 
absolute line number, a relative displacement from the current line, or a line 
name: Une number and current column position (twice). 

If the last target located was specified with "&", then only information about the 
last string found is returned. For example, if the last target located was a result 
of issuing the following command: 

LOCATE /a/ & /try/ 
and the line located. 

This try is even a better one 

1...+ 1 + 2 +..i.3 + 4 + 5 + 6 + 7... 

is on line 11 in the file and begins in column 1, EXTRACT /TARGET/ would 
return the following values. 

TARGET. 0=4 

TARGET. 1=11 (line number that contains "t") 
TARGET. 2=6 (column number that contains "t") 
TARGET. 3=11 (line number that contains "y") 
TARGET. 4=8 (column number that contains "y") 

These values are returned because "try" is the last string found in the target. 
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Information returned by EXTRACT/TARGET/ is only guaranteed to be valid 
when the EXTRACT is done immediately following the LOCATE or 
CLOCATE of the target. Any XEDIT subcommand issued between the 
LOCATE or CLOCATE of the target and the EXTRACT has the potential to 
invalidate the TARGET information. 

TARGET. number of variables returned 

.1 line number of first character 

.2 column number of first character 

.3 line number of last character 

.4 column number of last character 

TERMinal 

returns "DISPLAY" or "TYPEWRITER" as defined in the SET TERMINAL 
subcommand. 

TERMINAL. number of variables returned 

.1 DISPLAY 1 TYPEWRITER 

TEXT 

returns "ON" or "OFF" as specified in the SET TEXT subcommand. 

TEXT.0 number of variables returned 

.1 QNIOFF 

TOF 

returns "ON" or "OFF" as determined by the editor. TOF is "ON" when the 
line pointer reaches the Top of File (or Top of Range) line. 

TOF.O number of variables returned 

.1 ONIOFF 

TOFEOF 

returns "ON" or "OFF" as specified in the SET TOFEOF subcommand. 

TOFEOF. number of variables returned 

.1 ONIOFF 

TOL 

returns "ON" or "OFF" as determined by the editor. TOL is "ON" when the 
column pointer reaches zonel-1. 

TOL.0 number of variables returned 

.1 ONIOFF 

TRANSLat 

returns "ON" or "OFF", depending on whether or not the user has defined 
pairs of uppercase translate characters using the SET TRANSLAT 
subcommand. 

TRANSLAT. number of variables returned 

.1 ONIOFF 

TRunc 

returns the truncation column number as defined by the SET TRUNC 
subcommand. 

TRUNC. number of variables returned 

.1 truncation column number 

UNIQueid 

returns the unique identifier associated with the file. The identifier has the form 
rrrnnnnn where rrr is the number of times XEDIT was called recursively and 
nnnnn is the current autosave number. Note that when the recursion level, rrr, is 
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less than 100, the leading zero(es) will be dropped. The uniqueid is also used as 
the file name for the AUTOSAVE file. 

UNIQUEID. number of variables returned 

.1 unique identifier associated 

with this file 

UNTil 

returns the file type up through which updates were applied as specified on the 
XEDIT command or LOAD subcommand. 

UNTIL. number of variables returned 

.1 file type(if specified) or blanks 

UPDate 

returns "ON" or "OFF" as determined by the editor. Update is "ON" when the 
XEDIT command or LOAD subcommand has been issued and the UPDATE 
option was specified or impHed. 

UPDATE. number of variables returned 

.1 ONIOFF 

VARblank 

returns "ON" or "OFF" as specified in the SET VARBLANK subcommand. 

VARBLANK. number of variables returned 

.1 ONIOFF 

Verify 

returns the verification columns and "ON" or "OFF" as specified in the SET 
VERIFY subcommand. 

VERIFY.O number of variables returned 

.1 ONIOFF 

.2 columns 

VERShift 

returns n or -n, which is the relative position of the screen over the file, as a 
result of any LEFT or RIGHT subcommands. 

VERSHIFT. number of variables returned 

.1 n|-n 

Width 

returns the WIDTH value specified in the XEDIT command or LOAD 
subcommand. 

WIDTH. number of variables returned 

.1 width of file 

WINdow 

is the name of the virtual screen and window that XEDIT will use to display the 
file or files being edited. 

WINDOW.© number of variables returned 

.1 window name or blanks (for non-display 
terminals) 

WRap 

returns "ON" or "OFF" as specified in the SET WRAP subcommand. 

WRAP.O number of variables returned 

.1 ONIOFF 
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Zone 

returns the left and right zone column numbers specified in the SET ZONE 
subcommand. 

ZONE.0 number of variables returned 
.1 left zone 
.2 right zone 

returns the string in the equal( = ) buffer. The = buffer contains the last 
executed subcommand, macro, CP/CMS command, or whatever has been 
specified in the SET = subcommand. 

EQUALSIGN.O number of variables returned 
.1 the string in the = buffer 

Notes for Macro Writers 

1. The nimiber of variables returned by EXTRACT may depend upon whether the 
setting is "ON" or "OFF" or whether the settings were requested on a typewriter 
terminal. The following settings return a value of "name. = 0" on a typewriter 
terminal. No other variables associated with that setting will be initiaUzed: 



CMDLINE 


LSCREEN 


SCREEN 


CURSOR 


MSGLINE 


TABLINE 


FLSCREEN 


SCALE 





2. ff an error occurs while processing the request specified on the EXTRACT 
subcommand, a nonzero return code is returned and an error variable, 
EXTRACT.n is set. EXTRACT.O and EXTRACT. 1 are set on return codes 2, 5 
and 16 only. EXTRACT.O is always set to the number of error variables that 
are returned. If the return code is 2 or 5, then EXTRACT. 1 is set to the 
delimited string which was invalid (return code 5) or the delimited string 
containing a target that was not found (return code 2) when EXTRACT was 
invoked. All values prior to the one specified in EXTRACT. 1 will have been 
processed, while those following the one in error will not. 

However, when the return code is 16, EXTRACT. 1 is set to the name of the 
variable which was too long for the EXEC 2 restriction of a maximum value 
length of 255 characters. For example, if one is editing a file with a current line 
that is longer than 255 characters, and an EXTRACT /CURLINE/ is issued, 
then EXTRACT. 1 will be set to "CURLINE. 3". The setting of any other 
variables resulting from that invocation of EXTRACT is unpredictable. 
EXTRACT. 1 does not give an indication of what has or has not been set in this 
case. 

3. If EXTRACT is issued when an exec or XEDIT macro is not active, a return 
code of - 3 will be set and the following error message is displayed: 

631E EXTRACT can only be issued from an EXEC 2 or REXX exec. 

If XEDIT is invoked from an EXEC or XEDIT macro, then that EXEC or 
macro is "active" until you exit from XEDIT and subsequently from the EXEC 
or macro. Issuing EXTRACT from the XEDIT command line may set variables 
in the EXEC or macro that invoked XEDIT. 

4. EXTRACT/MASK/issued from an EXEC 2 environment will always result in 
return code 16 since the MASK has 256 characters. To obtain the same 
information, you may use TRANSFER MASK. EXTRACT/MASK/ issued 
from a REXX environment will return the mask properly, as REXX imposes no 
length restrictions. 
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Messages 



Return Codes 



Examples 



5. If SET HEX ON is in effect, targets can be specified in hexadecimal. 



545E Missing operand(s) [RC = 5] 
622E Insufficient [free] storage [message] [RC = 104] 

63 IE function can only be executed from an EXEC-2 or REXX EXEC [or as a 
CMS command] [RC = -3] 



— 3 Invalid when issued from an environment other than EXEC 2 or REXX 

2 Target not found 

5 Missing operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 

16 EXEC 2 variable greater than 255 characters 

104 No storage is available 



1. If you edit a new file with a default record length of 80 and issue: 
set Irecl 65 

and then execute an XEDIT macro which issues: 

extract /ACTION/ 

The following variables are set: ACTION. = 1 

ACTION. 1 = ON 

2. If you edit a new file SAMPLE FILE A and then execute an XEDIT macro 
which issues: 

extract ?C0L?fname?pf3? 

The following variables are set: COLUMN. = 1 

COLUMN. 1 = 1 

FNAME.0 = 1 

FNAME.l = SAMPLE 

PF3,0 = 2 

PF3.1 = BEFORE 

PF3.2 = QUIT 

3. While editing a file you make hne 6 the current line. There are no entries in the 
pending list. You then execute an XEDIT macro which issues: 

set pending block 3WW57 
extract ! pending block * :2 +5! 

The following variables are set: PENDING.© = 7 

PENDING. 1 = 6 
PENDING.2 = WW 
PENDING. 3 = WW 
PENDING. 4 = BLOCK 
PENDING. 5 = 3 
PENDING.6 = 57 
PENDING. 7 = null 
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4. While editing a file you execute an XEDIT macro which issues: 

set case mixed respect 

extract (fCASEctCOLOR ALUAUTOSAVE(t 

The following variables are set: CASE.O = 2 

CASE.l = MIXED 

CASE. 2 = RESPECT 

EXTRACT. = 1 

EXTRACT. 1 = COLOR ALL 

Note: The return code is 5 because COLOR ALL is an invalid operand and 
nothing is returned for AUTOSAVE (see notes for macro writers, 2). 

5. While editing a file on a typewriter terminal, you insert a Une containing the 
following text: 

Professor Twist could not but smile. 

With the line you just added being the current line, you then execute an XEDIT 
macro which issues: 

extract %SCALE%CURLINE% 
The following variables are set: 

SCALE. = 
CURLINE.0 = 4 
CURLINE.l = -1 
CURLINE.2 = -1 

CURLINE.3 = Professor Twist could not but smile. 
CURLINE.4 = ON 
CURLINE.5 = NEW 
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Format 



Use the FILE subcommand to write the edited file on disk or in an SFS directory. 
You may also use the FILE subcommand to override the file identifier originally 
supplied in the XEDIT command. 



FILE 




'fn 


ft 


fm 


J 



Operands 



fn 



ft 



fm 



indicates the file name for the file (or membername when editing a member of a 
MACLIB). If you do not specify fn (or = ), ft and fm cannot be specified, and 
the existing file name, file type, and file mode are used. 

indicates the file type for the file. 

is the file mode of the file to be written. 



Usage Notes 



1 . If the file mode indicates an accessed minidisk, the minidisk must be accessed 
read/write. If the file mode indicates an accessed SFS directory, it can be 
accessed as either read/only or read/write. 

2. You must have write authority to an existing file to file it in another user's SFS 
directory. 

3. If you have write authority to another user's SFS directory, you can create a 
new file in that directory even though you have the directory accessed read/only. 
The owner of the directory is now the owner of the new file, but because you 
created the file, you have write authority for the file. 

4. You can change the file name, file type, and file mode during an editing session 
by using the SET FNAME, SET FTYPE, and SET FMODE subcommands (as 
well as specifying a different file identifier on the FILE subcommand). 

5. If you change the file identifier (to a unique file identifier) and the file being 
edited had been previously written to disk or directory, that copy with the 
original name of the file is not altered. 

6. If you try to FILE a shared file that has been modified by another user during 
your editing session, the editor stops the FILE operation and displays the 
following message: 

594E File fn ft fm already exists or changed; use FFILE or SSAVE 

At this point you can decide whether to preserve the other user's changes or 
write over them. If you want to write over the other user's changes, causing 
them to be lost, enter FFILE (abbreviated as FF). If not, change the file 
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identifier so it is unique and reissue the FILE subcommand to save your changes 
under a different name. Later, you can determine what the differences are 
between the two versions of the file and combine them. 

To avoid this situation, use the LOCK option on the XEDIT command to 
prevent other users from changing the file while you are editing it. The LOCK 
option is the default. 

Message 594E is also displayed if you change the file identifier so that it is 
identical to that of an existing file and try to file it. 

This "protected FILE" works in the following way. FILE is defined as a 
synonym to PFILE, which is the protected equivalent of FILE. FFILE is a 
synonym for COMMAND FILE. 

7. An equal sign ( = ) may be used for any operand. Using an equal sign means 
that the corresponding value of the current file is to be used. 

8. If the FILE subcommand is issued for a file whose temporary copy in virtual 
storage has no records (that is, it is empty), the permanent copy of the file on 
disk or directory is not changed. The following message is displayed and the 
editor is exited: 

559W Warning: empty file not written to disk 

9. Changing a membername 

If you change the membername (to a unique membername) and the member has 
previously been written to a disk or directory, that copy with the original name 
of the member is not altered. 

However, if you change the membername while editing a member so that the 
new membername is identical to that of an existing member in that library, the 
editor stops the FILE operation and displays the following warning: 

594E File fn ft fm already exists or changed; use FFILE or SSAVE 

If you want to write over the existing member, enter FFILE (abbreviated as 
FF). If not, change the membername so that it is unique and reissue the FILE 
subcommand. 

10. Members of a MACLIB must have a file type of MEMBER. 

1 1 . Members with identical names contained in Ubraries with identical names, but 
residing on different disks or directories, will not be written over if you attempt 
to change the file mode. The following warning will be issued: 

594E File fn ft fm already exists or changed; use FFILE or SSAVE 

For example: 

PROJA MACLIB Al PROJA MACLIB Bl 

ENTER ENTER 

LEAVE LEAVE 

FORMAT FORMAT 

COMPUTE COMPUTE 

If you are editing the ENTER member in the PROJA MACLIB that resides on 
your file mode B and attempt to change the file mode by issuing "FILE = = 
A", the warning message is issued. 
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12. When editing two or more members of a MACLIB in member mode, the lock 
on the library is not deleted until the last member that had the lock option in 
effect exits the ring. 

Notes for Macro Writers 

1. If FILE is issued from a macro, the file is written to disk or directory, but 
control remains in the macro. When the macro finishes executing, control is 
returned to the editor. 

If multiple files were being edited, only the current file is written to disk or 
directory and removed from the set of files being edited. 

If only one file was being edited, a FILE issued from a macro sets the return 
code to 1 and executes the FILE when the macro completes execution. After 
issuing the FILE, any subcommands issued in the macro will result in a return 
code of 6. 

2. You cannot issue FILE, FFILE or PFILE from a prefix macro. However, if 
you issue a FILE, which consists of a SAVE and a QUIT, the SAVE will be 
performed and you will receive error message 509E on the QUIT. 



Responses 



If only one file was edited, the CMS ready message indicates that the file has been 
written to disk or directory. The user is returned to the environment that invoked 
the editor. 

If more than one file was being edited, the current file is written to disk or directory 
and is removed from the set of files being edited. 

On a typewriter terminal, the following message is displayed: 



5531 Editing file: fn ft fm 



Messages 



002E File fn ft fm not found [RC = 28] 

007E File fn ft fm is not fixed, 80-character records [RC = 32] 

033 E File fn ft fm is not a Ubrary [RC = 32] 

037E Filemode mode is accessed as read/only [RC = 12] 

039E No entries in Ubrary fn ft fm [RC = 32] 

048E Invalid mode mode [RC = 24] 

062E InvaUd character in fileid fn ft fm [RC = 20] 

069E Filemode mode not accessed [RC = 36] 

104S Error nn reading file fn ftfm from disk [RC = 3 1 , 55, 99, or 100] 

105S Error nn writing file fn ftfm on disk [RC = 55, 70, 76, 99, or 100] 

1 57S MACLIB limit exceeded [RC = 88] 

1 67S Previous MACLIB function not finished [RC = 88] 

229E Unsupported OS dataset, error nn [RC = 80, 81, 82, 83, or 84] 

509E subcommand subcommand not valid from a prefix macro [RC = 4] 

520E Invalid operand: operand [RC = 5] 

53 IE Disk or file space is full; set new filemode or clear some space [RC = 13] 

532E Disk or file space is full; AUTOSAVE failed 

554E Not enough virtual storage available [RC= 104] 

559W Warning: empty file not written to disk 

560E Not enough space for seriaUzation between TRUNC and LRECL 
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Return Codes 



579E Records truncated to nn when added to fn ft fm [RC = 3] 

594E File fn ft fm already exists or changed; use FFILE or SSAVE [RC = 3] 

598S Unable to build update file: internal list destroyed [RC = 7] 

599S Unable to build update file: serialization destroyed [RC = 7] 

622E Insufficient firee storage for reading map [RC= 104] 

11 38E File sharing conflict for file fn ft fm [RC = 70] 

1141 W User filespace threshold exceeded 

1 2 1 5E File fn ft fm is locked by another user [RC = 70] 

1258E Not authorized to write file fn ftfm [RC = 12] 

1262S Error nn opening file fn ft fm [RC = 55, 70, 76, 99, or 100] 

130 IS Rollback error nn, filQfnftfm left open 



Normal 

1 File has been filed and was the only one edited 

3 File already exists; truncated or spilled 

4 Invalid when issued from a prefix macro 

5 Invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 

7 Error building the update file 

12 Minidisk defined in file mode is read-only; or not authorized to write to file 

1 3 Minidisk or file space is full 

20 Invalid character in file name or file type 

24 InvaUd file mode 

28 File not found 

31 A rollback occurred 

32 File is not a library, or library has no entries, or file is not fixed, 80 char, 
records 

36 Corresponding minidisk or directory not accessed 

55 APPC/VM communications error 

70 File sharing conflict 

76 Connection error 

80 An I/O error occurred while an OS data set or DOS file was being read or an 
OS or DOS disk was detached without being released. 

81 The file is an OS read-password-protected data set or a DOS file with the input 
security indicator on. 

82 The OS data set or DOS file is not BPAM, BSAM, or QSAM. 

83 The OS data set or DOS file has more than 16 user labels or data extents. 

84 Unsupported OS data set 

88 Previous MacUb function not finished, or Machb limit exceeded 

99 A required system resource is not available 

100 Error 'nn' reading|writing file fromjto disk 
104 Insufficient virtual storage 
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FIND 



Format 



Use the FIND subcommand to search forward in the file for the first hne that starts 
with the text specified in the operand. Only the non-blank characters in the operand 
are checked against the file. The search starts with the line following the current 
hne. 



Find 



text 



Operand 



Usage Notes 



text 



is any text that you expect to find, beginning in column one of the next file line. 
If text contains imbedded blanks, those character positions in the file line are not 
checked. 



1 . If the SET IMAGE ON subcommand has been issued, tab characters are 
converted to blanks (or filler characters) before the search is made. In addition, 
the search starts in the first tab column. 

2. Use an underscore character (_) in the operand to specify that a blank character 
should be present in a hne. 

3. Only one blank can be used as a dehmiter following the FIND subcommand; the 
operand starts after the blank. 

4. See also FINDUP, NFIND, and NFINDUP. 

5. If the subcommand SET WRAP OFF has been issued, the search will continue 
until the end of file. 

If the subcommand SET WRAP ON has been issued, the search will continue 
through the entire file and stop when the line where it started is reached again. 
When a wrap occurs under these conditions, the following warning message is 

rJisnlavpH* 

592W Wrapped 



Response 
Messages 



6. The FIND subcommand updates the LASTLORC buffer. Refer to the SET 
LASTLORC subcommand in this pubhcation. 



If text is found, the line containing the specified text becomes the new current line. 



545E Missing operand(s) [RC = 5] 
586E Not found [RC = 2] 
592 W Wrapped .... 
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Return Codes 

Normal 

2 No line was found 

5 Missing operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 

Examples 

Current Line: 

===== Dingoes are wild dogs of Australia. 

I...+....1....+....2....+....3....+....4....+....5....+....6....+....7... 

===== They are called Dingoes. 

===== Dingoes do not bark. 

find Ding (text must start in column one of a line) 

New Current Line: 

===== Dingoes do not bark. 
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FINDUP 



Format 



Operand 



Usage Notes 



Response 



Use the FINDUP subcommand to search backward in the file for the first Une that 
starts with the text specified in the operand. Only the non-blank characters in the 
operand are checked against the file. The search starts with the Une preceding the 
current Une. 




text 



is any text that you expect to find beginning in column one of a file Une that 
appears before the current line. If text contains imbedded blanks, the 
corresponding character positions in the file are not checked. 



1 . If the SET IMAGE ON subcommand has been issued, tab characters are 
converted to blanks (or filler characters) before the search is made. In addition, 
the search starts in the first tab column. 

2. Use an underscore character (_) in the operand to specify that a blank character 
should be present in a line. 

3. Only one blank can be used as a delimiter following the subcommand; the 
operand starts after the blank. 

4. See also FIND, NFIND, and NFINDUP. 

5. If the subcommand SET WRAP OFF has been issued, the search will continue 
until the top of file. 

If the subcommand SET WRAP ON has been issued, the search will continue 
through the entire file and stop when the line where it started is reached again. 
When a wrap occurs under these conditions, the following warning message is 
displayed: 

592W Wrapped 

6. The FINDUP subcommand updates the LASTLORC buffer. Refer to the SET 
LASTLORC subcommand in this pubUcation. 



If text is found, the line containing the specified text becomes the new current line. 
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Messages 



545E Missing operand(s) [RC ■■ 
586E Not found [RC = 2] 
592W Wrapped .... 



5] 



Return Codes 



Normal 

2 No line was found 

5 Missing operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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FORWARD 



Format 



Operand 



Use the FORWARD subcommand to scroll toward the end of a file for a specified 
number of screen displays. 




Usage Notes 



is the number of screen displays you want to scroll forward. If you specify an 
asterisk, the hne pointer moves to the "End of File" hne. If you omit n, the 
screen scrolls forward for one display. 



1 . The FORWARD subcommand is assigned by the editor to the PF8 key. 

2. Issuing FORWARD from anywhere in the file makes the first line of the file the 
new current line. 



Responses 



Messages 



Return Codes 



If you issue the FORWARD subcommand when the current line is the last line of 
the file, the End of File line becomes the new current line. If you issue the 
FORWARD subcommand when the current line is the End of File line, the editor 
"wraps around" the file, making the first line of the file the new current line. 



520E Invalid operand: operand [RC = 5] 

529E Subcommand is only vahd in {display [editing} mode [RC^ 

543E Invalid number: number [RC = 5] 



3] 



Normal 

1 End of file reached (subsequent FORWARD restarts at top of file) 
3 Terminal is not a display 

5 Invalid operand or number 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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GET 



Use the GET subcommand to insert all or part of a specified CMS file after the 
current line of the file that you are editing. You can also use the GET subcommand 
without operands to insert lines saved by a previous PUT or PUTD subcommand. 



Format 



GET 




fn 


ft 


fm 




firstrec 
1 


numrec 
* 


11 



Operands 



fn 



ft 



fm 



is the file name of the file that contains the data to be inserted into the file you 
are editing. 

is the file type of the file that contains the data to be inserted. If ft is not 
specified, the file type of the file you are editing is assumed. 

is the file mode of the file that contains the data to be inserted. If you do not 
specify fm, all of your accessed modes are searched for the file. 



firstrec 

indicates the record number of the first record you want to insert. If firstrec is 
not specified, the first record in the file is the default. 

numrec 

indicates the number of lines to be inserted, starting with the line specified by 
firstrec. If numrec is not specified, or is specified as *, then the remainder of the 
file between firstrec and the end of the file is inserted. 



Usage Notes 



1 . The GET operand list is positional; if you omit one operand except for file 
mode, which is optional, you cannot specify any operands that follow. 
Therefore, if you want to specify firstrec and numrec, you must specify the file 
name and file type of the file. 

2. If you do not specify firstrec and numrec, the editor inserts the entire file. 

3. If the record length of the records in the file containing the data to be inserted 
exceeds that of the file being edited, records are truncated and a message is 
displayed, unless SET SPILL ON or SET SPILL WORD has been issued. In 
that case, a message is displayed indicating that the text has been spilled, and the 
characters beyond the record length are inserted in the file as one or more lines, 
starting with the first character or word that would have gone beyond the record 
length. If the record length is shorter, the records are padded with blanks to the 
record length of the file being edited and inserted in the file. 

4. If the editor fills up available storage while executing a GET request, it may not 
be able to copy all of the file. 

5. The operands fn, ft, or fm may be specified using an equal sign ( = ), in which 
case the corresponding value in the file being edited is used. 
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Responses 



Messages 



Return Codes 



6. If you issue a GET subcommand for a file that is in packed format, the editor 
does not unpack the file. 



The last hne inserted becomes the new current line. 

When the end of the file that is being inserted is reached, the following message is 
displayed: 

564W EOF reached 



002E 
048E 
062E 
069E 
104S 

156E 
229E 
520E 
521E 
543E 

554E 
557S 
562E 
563W 

564W 
565W 
1138E 
1262S 



FilQfnftfm not found [RC = 28] 

Invalid filemode mode [RC = 24] 

Invalid character in Qieidfnftfm [RC = 20] 

Filemode mode not accessed [RC = 36] 

Error nn reading rilefnftfm from disk [RC = 31, 55, or 100] 

Record nnn not found—file fnftfm has only nnn records [RC = 
Unsupported OS data set, error nn [RC = 80, 81, 82, 83, or 84] 
Invalid operand: operand [RC = 5] 
Invalid line number [RC = 5] 
Invalid number: number [RC = 5] 

Not enough virtual storage available [RC= 104] 
No more storage to insert lines [RC = 4] 
No Hne(s) saved by PUT(D) subcommand [RC = 28] 
Records { truncated | spilled} [RC = 3] 

EOF reached 

EOF reached; records {truncated| spilled} [RC = 3] 

File sharing conflict for file fnftfm [RC = 70] 

Error nn opening file fnftfm [RC = 31, 55, 99, or 100] 



32] 



Normal 

3 Truncated or spilled 

4 No more storage available to insert lines 

5 Invalid operand or (hne) number 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 

20 Invalid character in file name or file type 

24 Invalid file mode 

28 Source file not found 

31 A rollback occurred 

32 Record firstrec is beyond end of file 

36 Corresponding minidisk or directory not accessed 
55 APPC/VM communications error 
70 File sharing conflict 

80 An I/O error occurred while an OS data set or DOS file was being read or an 
OS or DOS disk was detached without being released. 

81 The file is an OS read-password-protected data set or a DOS file with the input 
security indicator on. 

82 The OS data set or DOS file is not BPAM, BSAM, or QSAM. 
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Examples 



83 The OS data set or DOS file has more than 16 user labels or data extents. 

84 Unsupported OS data set 

99 A required system resource is not available 

100 Error reading file firom disk 
104 Insufficient storage available 



The following are valid ways to issue a GET subcommand: 

get 

(insert all lines previously stored by a PUT or PUTD) 
get fne2 data 

(insert the entire file, FILE2 DATA, after current line of this file) 
get fileZ data 1 10 

(insert the first ten lines of FILE2 DATA) 

The following sequence illustrates how to use GET and PUT to transfer data 
between files, when editing multiple files: 

1. xedit filel mine 

This file appears on the screen. 

Position the line pointer at the hne after which you want to insert lines. 

2. xedit file2 data 

This file now appears on the screen. 

The status area indicates that you are editing two files. 

Move the line pointer to the beginning of Unes to be inserted, using, for 
example, CLOCATE, UP, NEXT, etc. 

3. put target 

Stores lines from current line up to the target line. 

4. quit 

The first file, FILEl MINE, reappears on the screen. 

5. get (no operands) 

The lines are inserted. 
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HELP (Macro) 



Format 



Operands 



Usage Notes 



Use the HELP macro to get online information about XEDIT subcommands, 
macros, and messages or to invoke the CMS HELP command. The XEDIT HELP 
facility allows you to display an individual XEDIT HELP file, a menu that lists all 
the XEDIT HELP files, or a series of menus that list XEDIT HELP files organized 
by various editing tasks. HELP files contain brief information, detailed descriptions, 
formats, parameters, options, usage notes, and related information for the XEDIT 
subcommands and macros. 




MENU 

displays a hst of all XEDIT subcommand and macro HELP files. 

HELP 

displays how to use the XEDIT macro HELP. 

TASK 

displays a hst of some task-oriented HELP files. 



name 



can be any XEDIT subcommand name or XEDIT macro name. Specifying a 
name causes a description of the subcommand or macro to be displayed. If 
name is not an XEDIT subcommand or macro, the entire HELP subcommand is 
transferred to the CMS HELP command, where it must follow the CMS HELP 
command syntax (refer to the VM/SP CMS Command Reference). 



1. XEDIT subcommand or macro abbreviations can be used in the name operand. 

2. Use the CMS HELP command format to display information on CMS as well as 
XEDIT error messages. For example: 

help dmsnnnnt or help dmsxxxnnnnt 

where xxx is the module name, nnnn is the message number, and t is the message 
type. 

3. HELP MENU is initially set to the PF1/PF13 key. 

4. Task menus are available in the RELATED sections of the SET, QUERY, and 
PREFIX commands. These RELATED task menus list and briefly describe the 
SET, QUERY, and PREFIX operands available in XEDIT. 

5. Error message text information has been replaced with a reference to the proper 
manual for information. But you can still use the ERRORS option to tailor 
your own HELP files. For information on tailoring your own HELP files, see 
the CMS User's Guide. 
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6. Although the RELATED option is available, few examples of RELATED 
information files will appear in the HELP files. However, you can use this 
option to tailor your own HELP files. For information on tailoring your own 
HELP files to include this option, see the CMS User's Guide. 

7. If you are viewing a command HELP file, you can issue the MOREHELP 
command from the command line. For example, if you are viewing the HELP 
file for the XEDIT CHANGE command and then decide you want to see the 
format section for that command, you can enter the following on the command 
line: 

MOREHELP (FORMAT 

The format section of the CHANGE command will then be displayed. 



Messages 
Return Codes 



From the CMS HELP faciUty. 



any number > 10 



Normal 

Subcommand rejected in the profile due to LOAD error, or 

QUIT subcommand has been issued in a macro called from the 

last file in the ring 

Standard CMS HELP command return codes 
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HEXTYPE (Macro) 



Format 



Operand 



Response 



Messages 



Return Codes 



Use the HEXTYPE macro to display a specified number of lines in both 
hexadecimal and EBCDIC. 




target 

defines the number of lines to be displayed in both hexadecimal and EBCDIC. 
The display starts with the current line and goes up to but does not include the 
target line. If you specify an asterisk (*), the rest of the file is displayed both 
ways. If you omit target, only the current line is displayed both ways. 

A target may be specified as an absolute line number, a relative displacement 
from the current line, a line name, or a string expression. For more information 
on targets, refer to the LOCATE subcommand in this book and to the 
publication VM/SP System Product Editor User's Guide. 



Each Une specified is displayed first in hexadecimal and then in EBCDIC. 
Only the data within the first pair of verify columns is displayed. 
The line pointer moves to the last line typed. 



520E Invalid operand: operand [RC = 5] 

546E Target not found [RC = 2] 

58 IE Subcommand is not valid in extended mode [RC = 3] 



Normal 

1 TOP or EOF reached 

2 Target line not found 

3 Subcommand is not valid in extended mode 

5 Invahd operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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Examples 



Current Line: 

===== To be or not to be - 

hextype (display the current line in hexadecimal and character) 
E3964082 85409699 409596A3 40A39640 82854060 
To be or not to be- 
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INPUT 



Format 



Operand 



Usage Notes 



Use the INPUT subcommand to insert a single line into a file, or, if no data line is 
specified, to leave edit mode and enter input mode. 




line 



is the input line to be entered into the file. It can contain blanks and tabs, 
which are converted to blanks if the SET IMAGE ON subcommand has been 
issued. The line is inserted after the current line, with the first character in the 
first tab column (only if SET IMAGE ON is in effect) and becomes the new 
current Hne. If you enter at least two blanks following the INPUT subcommand 
(and no additional text), a blank line is inserted into the file. 

The preceding description applies when the INPUT subconunand is entered in 
the form INPUT line. Input mode (INPUT entered with no operand) is 
described below. 



1 . When you issue the INPUT subcommand without an operand, the screen display 
changes in the following ways: 

a. The phrase "5731 Input mode:" appears in the message area, and 
"Input-mode n File(s)" appears in the status area of the screen. 

b. The phrase * * * Input Zone * * * appears in the command hne. 

c. The prefix area disappears from the display. 

d. All file lines following the current Une disappear from the display. Lines 
pre-fiUed with blanks appear in their place. (You can use the SET MASK 
subcommand to fill this area with something other than blanks.) This blank 
area, between the current line and the command line, is the input zone. 

e. The cursor is placed on the first line of the input zone, which is the blank 
line immediately following the current line. You can then type in new lines 
of data in the input zone. 

Only data typed in the columns defined by the SET VERIFY subcommand 
and up through the truncation column, (defined by the SET TRUNC 
subcommand) is accepted. Data that is entered beyond the truncation 
column or outside the current SET VERIFY settings is lost. 

2. When you fill up the screen but wish to stay in input mode and type in more 
lines, press the ENTER key once. The lines that you typed move to the top half 
of the screen, with the last line you typed becoming the new current line; it is 
followed by blank lines. If AUTOSAVE is set for your editing session, you may 
receive the message, 5101 Autosaved as 'fn ft fm' , depending on the value set 
on the SET AUTOSAVE subcommand. 
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3. When you are finished typing in data and want to return to edit mode, press the 
ENTER key twice. The last line you typed in input mode becomes the current 
Une, the screen layout is restored, the phrase "5871 XEDIT: " appears in the 
message area, and "XEDIT n File(s)" appears in the status area of the 
screen. (If you did not type in new lines while in input mode, you can return to 
edit mode by pressing the ENTER key once.) 

4. You can vary the size of the input zone by using the SET CURLINE 
subcommand to change which line on the screen is the current line. For a larger 
input zone, move the current line to the top of the screen; for a smaller input 
zone, move the current line lower on the screen. 

If you move the current line to the last available line in the file area, you cannot 
enter data unless you also move the command line (by using the SET 
CMDLINE subcommand). In general, you should leave space between the 
current line and the bottom of the screen for input mode. 

5. If you issue an INPUT subcommand when the current line is the End of File 
Une, the lines are inserted after the last file Une. 

6. When you use PF or PA keys in input mode, the editor automatically exits from 
input mode, enters edit mode to execute the subcommand associated with the PF 
or PA key, and returns to input mode. Therefore, you should carefully select 
which PF or PA keys you use in input mode. For example, if you press a PF 
key assigned to the FORWARD subcommand, the editor scrolls the screen 
forward and then returns you to input mode, but the input area will be on the 
next screen. In addition, some PF or PA keys are meaningless when used in 
input mode, for example, a PF key assigned to the ? subcommand. 

PF or PA keys that are particularly useful in input mode are those assigned to 
TABKEY, SPLTJOIN (or SPLIT and JOIN), NULLKEY, and RGTLEFT. 

7. On a typewriter terminal: 

a. Pressing the RETURN key causes any line that is typed in to be inserted 
into the copy of the file that is kept in storage. 

b. If the SET IMAGE ON subcommand has been issued, tabs are converted to 
blanks before a Une is inserted into the file. 

c. The editor interprets a line that has an escape character in column 1 (see the 
SET ESCAPE subcommand) as an XEDIT subcommand. The subcommand 
is executed and input mode is reentered automatically. (You cannot use 
SET ESCAPE on a terminal in DISPLAY mode.) 

d. Enter a null line to leave input mode and return to edit mode. 

8. If SET HEX ON is in effect, the line can be specified in hexadecimal. For 
example, INPUT X ' C1C2C3 ' . 

9. When the INPUT subcommand is entered with text specified (that is, in the 
form "INPUT Une"), and SET SPILL OFF is in effect (the default), characters 
entered beyond the truncation column are truncated. If SET SPILL ON or SET 
SPILL WORD has been issued, characters entered beyond the truncation 
column are inserted in the file as one or more new lines, starting with the first 
character or word that would have gone beyond the truncation column. 

When the INPUT subcommand is entered with no text specified (that is, in the 
form "INPUT") and input mode is entered, data is handled as described in 
usage note 1, above. 
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10. If you enter the LINEND symbol while in input mode and press the ENTER 
key, your line will not be entered as separate lines in the file. Instead, it will be 
shown as a string with the LINEND symbol appearing literally. 

1 1 . When you are at the end of file (or end of range), and you enter the INPUT 
subcommand, the last line of the file (or range) is displayed as the current hne, 
even if that line is not within the defined scope. 

12. If multiple logical screens have been defined by the SET SCREEN subcommand, 
then entering input mode causes subcommands entered on other logical screens 
to either 

a. be ignored, if the screen contains a view of the same file, or 

b. remain on the command line and not execute until input mode is exited, if 
the screen contains a view of a different file. 



Messages 



503E {Truncated|Spilled}[RC = 3] 
557S No more storage to insert Unes [RC = 4] 

614E Screen modifications lost. See SET FULLREAD ON to use PA keys 
safely [RC = 8] 



Return Codes 



Normal 

3 Truncated or spilled 

4 No more space available to add lines 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 

subcommand has been issued in a macro called from the last file in the ring 
8 Modifications lost because PA key pressed when message pending 
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Format 



JOIN 



Use the JOIN macro to combine two or more lines into one replacement line. 

The first format enables you to join two lines at the column pointer or at the cursor. 

The second format enables you to join two or more lines at a specified column 
number(s) or to insert a specified character string(s) before appending the next Une. 

In all cases, the lines that are appended (the original lines) are deleted. However, if 
data precedes zonel (see SET ZONE), only the data following zone 1 is deleted. 



Join 



[ALigned] Column 
CURSOR 



[ALigned] colno 
fstringi 



Operands 



no operand 

joins the current line and the next line. The next line is appended after the first 
trailing blank in the current line. 

ALigned 

removes up to the same number of leading blanks from the line being joined as 
there are on the line to which it is appended. 

Column 

joins the current Une and the next line, which overlays the current line starting at 
the column pointer. The line pointer and the column pointer remain unchanged. 

CURSOR 

joins the line containing the cursor and the next line, which overlays the Une 
starting at the cursor position. JOIN CURSOR is most useful when assigned to 
a PF key. 

colno 

specifies a column number in the current line where the next line is to be 
appended. Subsequent consecutive lines are appended to (and overlay the 
contents of) the current line for as many times as there are column numbers 
(colno) specified. 

Istringl 

inserts the specified string (without deUmiters) in the current line, starting at the 
first trailing blank location. Then the next line is appended after the string. 
This process is repeated for as many times as there are /string/ operands 
specified. 
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Usage Notes 



1. If SET SPILL ON or SET SPILL WORD has been issued, characters that have 
been pushed beyond the truncation column are inserted in the file as one or 
more new lines, starting with the first character or word that would have gone 
beyond the truncation column. For the JOIN macro, SET SPILL OFF (the 
default) has the same effect as SET SPILL ON. JOIN does not truncate data. 

2. The original Unes that are appended as a result of a JOIN macro are deleted, 
unless data precedes zone 1 (see SET ZONE). In this case only the data 
following zone 1 is deleted. 

3. Before using JOIN COLUMN, check to see if the column pointer is in the 
desired location, because the next line is appended starting at the column 
pointer. Use the CLOCATE subcommand to move the column pointer, if 
necessary. 

4. The Une pointer and column pointer remain unchanged. 

5. JOIN is the converse of SPLIT. See also SPLTJOIN, which combines SPLIT 
and JOIN. 

6. The cursor or the column number or string specified must fall within the current 
zones. 



Messages 



503E {TruncatedlSpilled} [RC = 3] 

520E InvaUd operand: operand [RC = 5] 

526E Option option valid in display mode only [RC = 3] 

561 E Cursor is not on a vaUd data field [RC = 1] 

564W EOF reached [RC = 1] 

575E InvaUd [argument or]{JOIN|SPLIT|TABS|VERIFYiZONE} columns 

defined [RC = 5] 

585E No line(s) changed [RC = 1] 

68 5E Joined Hnes(s) exceed zone settings [RC = 5] 



Return Codes 



Normal 

1 No line(s) changed, or cursor is not on a vaUd data field 
3 Spilled, or operand is vahd only for display terminal 

5 Invalid operand, or joined line(s) exceed zone settings 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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Examples 

If you assign PFll to JOIN CURSOR: 

set pfU join cursor 

===== This line is _ 
===== too short. 

Note position of the cursor ( _ ) in the first line. Pressing the PFll key produces the following line: 

===== This line is too short. 

Using JOIN to Insert a Character String: 

===== .sp 

===== .in 5 
===== .of 3 

join /;/ /;/ (join the current line and the next two, separated by semi-colons) 

===== .sp;.in 5;. of 3 

Using JOIN ALIGNED to remove up to the same number of leading blanks from the line being joined to the 
current line: 

===== These lines have _ 

===== leading blanks. 

join al cursor 

===== These lines have leading blanks. 

Using JOIN to Join Lines Separated by Blanks: 

===== Electric eels 
===== can discharge bursts 
===== of 625 volts. 

join / / / / (join current hne and next two, separated by blanks) 

===== Electric eels can discharge bursts of 625 volts. 
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Format 



Operand 



Usage Notes 



Use the LEFT subcommand to view columns of data that are not currently visible 
on the screen. The LEFT subcommand allows you to see data that is to the left of 
the first column on the screen. The data moves to the right, thus allowing you to see 
a specified number of positions to the left of the first column. 




specifies the number of positions to the left of the first column on the screen that 
you want to see. If you omit n, one position to the left of the first column 
becomes visible. 



1 . The LEFT subcommand does not cause data to be lost, nor does it move the 
Une or column pointer. 

2. To get the data back to its original position, use the RIGHT n subcommand. 
See also the RGTLEFT macro in this publication. 

3. LEFT subcommands are cumulative. For example. 



left 


10 




left 


10 




is equivalent 


to 


left 


20 





Therefore, if several LEFT subcommands have been issued, column one on the 
screen might not contain the first character in a line. 

4. If you have issued several LEFT and/or RIGHT subcommands and have 
forgotten the value of n: 

a. LEFT or RIGHT restores the screen to its original display. 

b. SET VERIFY resets LEFT (or RIGHT) to zero. 

c. QUERY VERSHIFT displays -n (result of a LEFT) or n (result of a 
RIGHT). 

5. The total number of columns specified cannot exceed the logical record length. 

Notes for Macro Writers 

EXTRACT /VERSHIFT/ returns the value of n or minus n. 
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Response 
Messages 



Return Codes 



The screen moves to the left relative to the file data. 



520E Invalid operand: operand [RC = 5] 
543E Invalid number: number [RC = 5] 

576E (Total verify width exceeds screen size (nn)|Total offset exceeds LRECL 
(««)} [RC = 5] 



Normal 

5 Invalid operand or number, or total verify width exceeds screen size 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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Examples 



Figure 8 is a before-and-after example of the LEFT subcommand. 



OGDEN NASH Al V 132 Trunc=132 Size=28 Line=10 Col=l AU=0 

===== THE PANTHER 

===== THE PANTHER IS LIKE A LEOPARD, 
===== EXCEPT IT HASN'T BEEN PEPPERED. 
===== SHOULD YOU BEHOLD A PANTHER CROUCH, 
===== PREPARE TO SAY OUCH. 
===== BETTER YET. IF CALLED BY A PANTHER. 
===== DON'T ANTHER. 

===== THE CANARY 

|... +....!.... +....2.... +....3.... +....4.,.. +....5.... +....6.... +....7.. 

===== THE SONG OF CANARIES 
===== NEVER VARIES. 

===== AND WHEN THEY'RE MOULTING 
===== THEY'RE PRETTY REVOLTING. 

===== THE GIRAFFE 

===== I BEG YOU, CHILDREN, DO NOT LAUGH 
====> left 15 

X E D I T 1 File 



OGDEN NASH 



■10. 



Al V 132 Trunc=132 Size=28 Line=10 Col=l Alt=0 

THE PANTHER 

THE PANTHER IS LIKE A LEOPARD, 
EXCEPT IT HASN'T BEEN PEPPERED. 
SHOULD YOU BEHOLD A PANTHER CROUCH, 
PREPARE TO SAY OUCH. 
BETTER YET, IF CALLED BY A PANTHER, 
DON'T ANTHER. 



THE CANARY 
I. .. + ... 10. 



,20. 



.30. 



.40. 



THE SONG OF CANARIES 
NEVER VARIES. 
AND WHEN THEY'RE MOULTING 
THEY'RE PRETTY REVOLTING. 

THE GIRAFFE 

I BEG YOU, CHILDREN, DO NOT LAUGH 



.50. 



Figure 8. The LEFT Subcommand — Before and After 



X E D I T 1 File 
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Format 



LOAD 



Use the LOAD subcommand to read a copy of the file being edited into virtual 
storage. The LOAD subcommand can be issued only from the XED IT profile. Its 
purpose is to allow the profile (macro) to prompt the user for editing options or to 
assign default values for editing variables. The LOAD subcommand has the same 
format and editing options as the XEDIT command; however, the options specified 
in the XEDIT command override those specified in the LOAD subcommand. 



LOAD 



[fn [ft [fm]]] [(C)ptions...[)] ] 

Options: 

[ Width nn ] [ NOSCreen ] [ PROFile macroname ] 
[NOPROFil] [NOCLear] [NOMsg] 
[MEMber membername] LWINdow wnamej 

LOCk 
NOLOCk 

Options Valid Only in Update Mode: 



Update 
NOUpdate 



Seq8 



Ctl fnl 
NOCtl 



NOSeq8 

[Merge] [UNtil filetype] [incr nn] 
[SIDcode string ] 



Usage Notes 



For a description of the editing options, refer to the XEDIT command description. 
Remember that the options specified with the XEDIT command (or subcommand) 
override those specified with the LOAD subcommand. 



1 . WINdow wname is the name of the virtual screen and window that XEDIT will 
use to display the file or files being edited. For more information on virtual 
screens and windows, see Appendix G, "XEDIT Virtual Screens and Windows" 
on page 441. 

2. The WIDTH option specifies the amount of virtual storage to be used for one 
file line. 

If, upon editing an existing file, the value of WIDTH specified in the LOAD 
subcommand is too small to contain a file line, it is overridden by: 

a. The WIDTH value, if specified, in the XEDIT command. 

b. The logical record length of the file being read. 

Therefore, the value of WIDTH specified in the LOAD subcommand cannot 
cause unwanted truncation. 
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For newly created files, WIDTH will be the value specified on the LOAD 
subcommand unless it is overridden by the value specified on the XEDIT 
command. 

If WIDTH is not specified in either the LOAD subcommand or the XEDIT 
command, its value is the greater of: 

a. The logical record length (LRECL) of the file, or 

b. The default logical record length associated with the file type. See 
Appendix A, "File Type Defaults" on page 403. 

Note that WIDTH is the only option that has a different meaning in the LOAD 
subcommand and XEDIT command. 

3. The following XEDIT variables are assigned default values when the LOAD 
subcommand is executed. These variables can be changed during editing by the 
SET subcommand: 

LRECL 
TRUNC 
ZONE 
VERIFY 

LRECL 

is the logical record length that is used when the file is written to disk or 
directory. For files with a variable (V) record format, the LRECL is 
assigned the value specified in WIDTH. Thus, the longest record 
cannot exceed the value of WIDTH. 

For files with a fixed (F) record format, the LRECL assigned is one of 
the following: 

• If the file existed and has been read from a disk or a directory, the 
LRECL assigned is the logical record length of the file. 

• If the file is new, LRECL is either WIDTH or the default logical 
record length assigned to the file type, whichever is smaller. 

TRUNC 

is assigned the value of LRECL, except for fixed (F) format files, which 

have a default value associated with the file type. 
ZONE 

is initially set to 1 (zonel) and TRUNC (zone2). 

VERIFY 

is assigned the value of TRUNC unless otherwise specified (See 
Appendix A, "File Type Defaults" on page 403). 

For a list of file type defaults, see Appendix A, "File Type Defaults" on 
page 403. 

4. Within the profile macro, the LOAD subcommand must be the first XEDIT 
subcommand. If it is not, a LOAD subcommand is automatically issued by the 
editor; its operands are the same as those issued in the XEDIT command. 
(EXEC 2 statements, REXX instructions, and CMS commands can be issued 
before the LOAD. When a CMS command is issued before the LOAD, the 
command must be specifically addressed to CMS. In REXX, use ADDRESS 
CMS and in EXEC 2 use &COMMAND.) 

A synonym cannot be used to specify the LOAD subcommand. Multiple 
subcommands may not be specified with the linend character following the 
LOAD subcommand. 
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LOAD 



5. The profile macro can be used to prompt the user for XEDIT command options 
or to assign values to editing variables before issuing the LOAD subcommand. 
For example, a SCRIPT user might program his profile to use a LOAD 
subcommand that does defaulting of file type. For example: 

parse arg fn ft '(' options 
if ft = " then ft = 'SCRIPT' 
LOAD fn ft '(' options 

6. The options specified in the LOAD subcommand have a lower priority than 
those in the XEDIT command. For example, UPDATE specified in the LOAD 
subcommand would be overridden by NOUPDATE specified in the XEDIT 
command. 

Thus, with the proper profile, all options in the XEDIT command (or 
subcommand) can be made optional. 

As a general rule, options in the LOAD subcommand indicate general user 
preferences that can be overridden by options specified in the XEDIT command 
itself. 

7. If the LOAD is unsuccessful, a non-zero return code is generated. All 
subsequent subcommands in the profile are rejected with a unique "6" return 
code, and the editor automatically issues a QUIT subcommand. 



When editing a file that resides in an SFS directory, if you have only read authority 
to the file and you do not specify the NOLOCK option, you will receive the 
message: 



The editing session will continue but the file will not be locked. 

The following messages are displayed only if you are using XEDIT in update mode: 



1781 Updating fn ft fm 
Applying fn ft fm 



180W Missing PTF file /n ft fm 
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Messages 



002E 
003E 
024E 
029E 
048E 

054E 
062E 
065E 
066E 
069E 

OTOE 
104S 
109S 
132S 
229E 

500E 
508E 
554E 

555E 
5711 

622E 
915E 
927E 
928E 
1138E 

1214W 
1215E 

1262S 

1299W 

1300E 



File fn ft fm not found [RC = 28] 

Invalid option: option [RC = 24] 

File XEDTEMP CMSUTl Al already exists [RC = 28] 

Invalid parameter parameter in the option option field [RC = 24] 

Invalid mode mode [RC = 24] 



Incomplete fileid specified [RC = 24] 
Invalid character in fileidfnftfm [RC = 20] 
option option specified twice [RC = 24] 
option] and option2 are conflicting options [RC ■■ 
Filemode mode not accessed [RC = 36] 



^24] 



Invalid parameter parameter [RC = 24] 

Error nn reading filQfnftfm fi-om disk [RC = 31, 55, or 100] 

Virtual storage capacity exceeded [RC = 104] 

File fn ftfm too large [RC = 88] 

Unsupported OS dataset, error nn [RC = 80, 81, 82, or 83] 

Unable to unpack file fn ft fm [RC = 88] 

LOAD must be the first subcommand in the profile [RC = 3] 

Not enough virtual storage available [RC = 104] 

File fn ft fm already in storage [RC = 4] 

Creating new file: 

Insufficient free storage for {MSGLINE|PFkey/PAkey| synonyms} 

Maximum number of windows already defined [RC = 1 3] 

The virtual screen must contain at least 5 lines and 20 columns [RC = 24] 

Command is not vahd for virtual screen CMS [RC = 12] 

File sharing conflict for file fn ft fm [RC = 70] 

File fn ft fm already locked SHARE 

File fn ftfm is locked {SHARE|UPDATE|EXCLUSIVE} by another user 

[RC = 70] 

Error nn opening Tile fn ftfm [RC = 31, 55, 70, 76, 99, or 100] 

Warning: Not authorized to lock filefnftfm 

Error nn {locking! unlocking) Rlefnft {fm\dirname} [RC = 55, 70, 76, 99, or 

100] 



Messages with Member Option 

007E File fn ft fm is not fixed, 80-character records [RC = 32] 

033E File fn ftfm is not a library [RC = 32] 

039E No entries in library /«/if/w[RC = 32] 

167S Previous MACLIB function not finished [RC = 88] 

622E Insufficient free storage for reading map [RC= 104] 
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Messages with Update Options 

007E File fn ft fm is not fixed, 80-character records [RC = 32] 

007E File fn ft fm does not have a logical record length greater than or equal to 

80[RC = 32] 

007E File fn ft fm does not have the same format and record length sisfnftfm 

[RC = 32] 

007E File fn ft fm is not fixed record format [RC = 32] 

104S Error nn reading file fn ftfm from disk [RC = 3 1 , 32, or 55] 

174W Sequence error introduced in output file: seqnol to seqno2 [R.C = 32] 

1781 Applying /n/r/m 

179E Missing or invalid MACS card in control Tikfnftfm 

1 80W Missing PTF file fn ft fm 

183E Invalid (CONTROLI AUX} file control card [RC = 32] 

184W ./ S not first card in update file-ignored [RC = 32] 

185W Non numeric character in sequence field seqno [RC = 32] 

186W Sequence number [seqnol] not found [RC = 32] 

207W Invalid update file control card [RC = 32] 

210W Input file sequence error: seqnol to seqno2 [RC = 32] 

570W Update ft specified in the UNTIL option field not found 

597E Unable to merge updates containing ./S cards [RC = 32] 

1262S Error nn opening mtfnftfm [RC = 31, 55, 70, 76, 99, or 100] 



Return Codes 



Normal 

3 LOAD has already been issued 

4 File is already in storage 

5 Invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 

12 Command is not vahd for virtual screen 

13 Maximum nimiber of windows already defined 
20 Invahd character in file name or file type 

24 Invalid parameters or options 

28 Source file not found (UPDATE MODE), or library not found (MEMBER 

option), or specified PROFILE macro does not exist, or file XEDTEMP 

CMSUTl already exists 

31 A rollback occurred 

32 Error during updating process, or file is not a library, or library has no entries, 
or file is not fixed, 80 char, records 

36 Corresponding minidisk or directory not accessed 
55 APPC/VM communications error 
70 File sharing conflict 

76 Connection error 

80 An I/O error occurred while an OS data set or DOS file was being read or an 
OS or DOS disk was detached without being released. 

81 The file is an OS read-password-protected data set or a DOS file with the input 
security indicator on, 

82 The OS data set or DOS file is not BPAM, BSAM, or QSAM. 

83 The OS data set or DOS file has more than 16 user labels or data extents. 

88 File is too large and does not fit into storage, or previous Maclib function was 

not finished 
99 A required system resource is not available 
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100 Error reading the file into storage 
104 Insufficient storage available 
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Format 



Operands 



LOCATE 



Use the LOCATE subcommand to scan the file for a specified target, which (if 
found) becomes the new current line. The search starts with the line following the 
current line. Optionally, an XEDIT subcommand may be specified; it is executed 
starting at the specified target. 

Note: To display all occurrences of a given string, use the ALL macro. 




Locate 

is the subcommand name but is optional. 
LOCATE subcommand. 

target 



The target operand itself impUes the 



defines the line that is to become the new current line. It can be specified as an 
absolute line number, a relative displacement from the current line, a line name, 
a simple string expression, or a complex string expression. A complete 
description of targets follows. 

subcommand 

is any XEDIT subcommand, which is executed starting at the specified target. 



Usage Notes 



Targets 

The ability to locate a line via a target is one of the editor's most versatile functions. 
A target is used not only as the operand of the LOCATE subcommand but also as 
an operand in many other XEDIT subcommands. 



A target is a way to define a Une to be searched for within the current top and 
bottom of the file (or top and bottom of the range — see SET RANGE) and between 
the beginning and end of each line (or between the left and right zones — see SET 
ZONE). 

A target can be as simple or as complex as the user desires. It can be expressed in 
the following ways: 

1. An absolute line number is a colon (:) followed by a file Une number. For 
example: 

:8 

makes file Une mmiber 8 the new current Une. 

2. A relative displacement from the current line is an integer and may be preceded 
by a plus ( + ) or minus ( — ) sign, which indicates a forward ( + ) or backward 

( — ) displacement from the current Une. If the sign is omitted, a plus (+) is 
assumed. 

A relative displacement may also be specified as an asterisk (*), which means the 
Top of File (- *) or the End of File ( + * or *) line. When an asterisk is specified 
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as the target operand of a subcommand, the subcommand executes to the end 
(or top) of the file. For example, DELETE * deletes lines from the current line 
to the end of the file. Examples of relative displacement follow: 



+3 



-5 



+* 



The target is three logical lines down (toward the end of the file) from 
the current line. 

The target is five logical Unes up (toward the top of the file) from the 
current Hne. 

The target is the null End of File (or End of Range) line. 



The target is the null Top of File (or Top of Range) line. 

:5 copy +3 :25 

requests that lines 5, 6, and 7 be copied after line number 25. 

In this example, three targets are specified. The first (:5) is a LOCATE, 
even though the subcommand name is not specified. 

3. A line name is one to eight characters preceded by a period (.), which has been 
previously defined by a SET POINT subcommand or a .xxxx prefix 
subcommand (which limits the name to four characters). For example: 

. PART2 

locates the file line whose name is PART2 and makes it the current line. 

The SET CASE (UPPERCASE or MIXED) option determines whether the line 
name is translated to uppercase. Additionally, in locating a line name target, 
uppercase and lowercase characters are significant regardless of the SET CASE 
option RESPECT or IGNORE. 

4. A string expression defines a group of characters to be located. The characters 
in the string must be deUmited by any character that does not appear in the 
string itself. However, if the XEDIT special characters ( + — .) are used to 
delimit a string target, the search direction (+ or — ) must be stated expUcitly. 
When a string target is entered by itself (without the optional subcommand 
name LOCATE), the dehmiter must be a diagonal (/). In the following 
examples, a diagonal (/) is used. 

If SET HEX ON has been issued, a string may be specified in hexadecimal 
notation, and the editor searches for its EBCDIC equivalent. For example, if a 
string is specified as /X'C3D4E27, the editor searches for the string "CMS". 

The general format for a string expression is: 



[+l-][--]/stringl[/&[^]/string2/[|H/string3]]... 
abed e 



a. The search direction is toward the end of the file ( + ) or toward the top of 
the file ( — ). If the sign is omitted, a plus ( + ) is assumed. 

b. "NOT" symbol (Locate something that is not the specified string.) 
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c. Character (or hexadecimal) string. The trailing delimiter may be necessary 
in certain circumstances. For example, if string 1 has trailing blanks, the 
trailing delimiter should be used to indicate where the string ends. 

d. "AND" symbol (ampersand) (Locate the line containing string 1 and 
string2.) 

e. "OR" symbol (vertical bar) (Locate any of the strings, separated by OR 
symbols, starting with the first string specified.) 

For example: 

/horse/ 

searches downward in the file, beginning after the current line, for the 

first line that contains "horse" and makes it the current line. 
— i/house/ 

searches downward in the file for the first line that does not contain 

"house" and makes it the current line, 
/horse/ & /house/ | /hay/ 

searches downward in the file for a line that contains either both 

"horse" and "house" or §. line that contains "hay," whichever comes 

first. 

Targets that are "anded" together can overlap. For example, 

"L/Tliis/&/liistory/" could find the string "Thistory" as well as the string 

"This history". 
/horse/|-i/house/ 

searches downward in the file for the first line that contains "horse" or 

does not contain "house." 
-/X'C17I/X'C27 

searches upward for the first line containing either or both of the strings 

specified here in hexadecimal. 

If SET HEX ON is in effect, the editor locates a hne containing "A" or 
"B." If SET HEX OFF is in effect, the editor locates a line containing 
"X'Cl'"or"X'C2'." 



// 



advances the Une pointer by one line. 



5. A complex string expression has the same format as a simple string expression. 
A string can be expressed as a "complex string" by associating it with one or 
more of the following SET subcommand options: 

SET ARBCHAR 

allows you to specify only the beginning and end of a string, using an 
arbitrary character to represent all characters in the middle. 

SET CASE 

allows you to specify whether or not the difference between uppercase 
and lowercase is to be significant in locating a string target. 

SET ETARBCH 

See Appendix F. 

SET SPAN 

allows you to specify if a string target must be included in one file line 

or if it may span a specified number of Unes. 
SET VARBLANK 

allows you to control whether or not the number of blank characters 

between two words is significant in a target search. 
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For example: 

LOCATE and SET ARBCHAR 

set arbchar on . 
/air. plane/ 

would locate in the text either one of the following: 

"the airplane was landing" 
"cold air surrounded the plane" 

LOCATE and SET CASE 

set case m ignore 
/computer/ 

would locate in the text any of the following: 

"computer" 
"Computer" 
"comPUTer" 

LOCATE and SET' SPAN 

If SET SPAN OFF is in effect, a string must be contained within one file line in 
order to match a target. 

If SET SPAN ON is in effect, a string may start on one line and continue on n 
lines (as specified in the SET SPAN subcommand) and still match a target. 

LOCATE and SET VARBLANK 

set varblank on 
/the house/ 

will locate in the text either of the following: 

"the house" 

"the house" 

Note: Target as discussed here is actually a line target and is not to be confused 
with a column-target, which is used as the operand of only the CLOCATE and 
CDELETE subcommands. 

Usage Notes for LOCATE Targets 

1. LOCATE targets and SET STAY: If SET STAY OFF is in effect and the target 
is not located, the new current line is the bottom (or top) of the file (or range). 

If SET STAY ON is in effect and the target is not located, the line pointer 
remains unchanged. 

2. LOCATE targets and SET WRAP: If SET WRAP OFF is in effect, the search 
for a string expression target stops with the end of file or range (or top of file or 
range). 

If SET WRAP ON is in effect, the editor wraps around the file and continues 
the search for a string expression up to and including the line preceding the 
current line. If a range has been defined, the editor wraps around the bottom of 
the range and continues at the top of the range (or if the search is in the other 
direction, the editor wraps around the top and continues at the bottom). 
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When a wrap occurs under these conditions, the following warning message is 
displayed: 

592W Wrapped 



3. The LOCATE subcommand updates the LASTLORC buffer. 
LASTLORC subcommand in this pubUcation. 



Refer to the SET 



Notes for Macro Writers 

In a macro, an implicit backward locate (for example, - 3) is interpreted by EXEC 2 
as a label. To avoid this problem, use the LOCATE subcommand explicitly (for 
example, LOCATE - 3), or use the COMMAND subcommand (COMMAND - 3). 



Messages 



Return Codes 



520E Invalid operand: operand [RC = 5] 

545E Missing operand(s) [RC = 5] 

546E Target not found [RC = 2] 

592 W Wrapped .... 



Normal 

1 TOP or EOF reached 

2 No target line was found 

5 Invalid or missing operand(s) 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 

nn Return code from subcommand following LOCATE 
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LOWERCAS 



LOWERCAS 



Format 



Operand 



Usage Note 



Use the LOWERCAS subcommand to change all uppercase letters to lowercase in 
one or more lines of the file, starting with the current line. 




target 

defines the number of lines to be translated. Translation starts with the current 
Une and continues up to, but does not include, the target hne. If you specify an 
asterisk (*), the rest of the file is translated. If you omit target, only the current 
line is translated. 

A target may be specified as an absolute line number, a relative displacement 
from the current line, a hne name, or a string expression. For more information 
on targets, refer to the LOCATE subcommand in this book and to the 
publication VM/SP System Product Editor User's Guide. 



The LOWERCAS subcommand does not alter the setting of the SET CASE 
subcommand. 



Responses 



1 . All uppercase letters within the current zones are changed to lowercase. 

2. If you specify that a LOWERCAS is to occur on multiple lines and the 
LOWERCAS occurs, the current line pointer will be: 

1) Unchanged, if SET STAY ON has been issued 

2) Moved to the last hne translated, if SET STAY OFF is in effect (the 
default). 



Messages 



Return Codes 



520E Invalid operand: operand [RC = 5] 
546E Target not found [RC = 2] 
58 5E No Hne(s) changed [RC = 4] 



Normal 

1 TOF or EOF reached during execution 

2 Target line not found 

4 No nne(s) changed 

5 Invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the rini 
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LOWERCAS 



Examples 



===== Tortoises of the Galapagos Islands can live to be 100 years old. 

1 ow (translate the current line to lowercase) 

===== tortoises of the galapagos islands can live to be 100 years old. 
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LPREFIX 



LPREFIX 



Format 



Operand 



Use the LPREFIX subcommand to simulate writing in the prefix area of the current 
line. LPREFIX can be used on typewriter terminals to utilize some of the features 
of prefix subcommands and macros, as well as on display terminals, irrespective of 
the appearance or position of actual prefix areas on the screen (see the SET PREFIX 
subcommand). 




text 



specifies up to five characters. All prefix subcommands and macros are put in a 
"pending Ust" before they are called. If no text is specified for LPREFIX, the 
pending Ust is executed immediately. If text is specified, the text is placed in the 
pending list for the current line and the pending Ust is then executed. For more 
information about the pending Ust, refer to the SET PENDING subcommand. 



Usage Notes 



1. Note that the action taken after LPREFIX is identical to the action taken when 
you enter the same "text" subcommand directly in the prefix area of the current 
Une and press ENTER. 

2. "LPREFIX text" is equivalent to issuing "SET PENDING ON string" and 
pressing ENTER again. 

3. LPREFIX cannot be issued from a prefix macro. 

4. The prefix subcommands and macros that are useful on a typewriter terminal via 
LPREFIX are: 

D,DD 
II II It 

c,cc 

M,MM 
X,XX 
<,« 
>,» 

• XXXX 

p 

F 



Messages 



509E subcommand subcommand not valid from a prefix macro [RC ■■ 
520E Invalid operand: operand [RC = 5] 



■A] 
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LPREFIX 



Return Codes 



Example 



Normal 

4 Invalid when issued from a prefix macro 

5 Invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 



Nefarious Nelly put her grocery list online. Every day she added more items. At 
the end of the week, she wanted to organize the list in the following order: meat, 
fruit, vegetables. Working at a typewriter terminal, she used the LPREFIX 
subcommand to move the grocery items appropriately. The following is a Usting of 
her file's contents: 



TOF: 

load Toes 
Newt Eyes 
Salmon Scales 
Root of Hemlock 
Baneberries 
Poison Plums 
Paltry Peaches 
EOF: 



Nelly moves to the top of the file by typing "top" and then moves down to the line 
"BANEBERRIES" by typing "n5". 

top 



TOF: 



n5 



Baneberries 



To move the last three Unes of the file (the fruit) so that they follow Salmon Scales 
(the last Une of the meat group), Nelly used the LPREFIX subcommand as shown in 
the following sequence: 

1 prefix mm 
n2 



Paltry Peaches 
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LPREFIX 



1 prefix mm 
top 



TOF: 



n3 



Salmon Scales 



1 prefix f 

The resulting file: 

top 



TOF: 



TOF: 

Toad Toes 
Newt Eyes 
Salmon Scales 
Baneberries 
Poison Plums 
Paltry Peaches 
Root of Hemlock 
EOF: 
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MACRO 



Format 



MACRO 



Use the MACRO subcommand to cause the specified operand to be executed as a 
macro. 



MACRO 



[macroline] 



Operand 



Usage Notes 



Responses 
Message 
Return Codes 



Examples 



macroline 

is an XEDIT macro name and its arguments (if any). 

The first word in the macroUne is assumed to be an XEDIT macro name. It 
starts with the first non-blank character following the subcommand name 
MACRO, and it ends with the first character followed by a blank. The name 
can be from one to eight characters long; it is truncated to eight characters, if 
necessary. 



1 . The MACRO subcommand causes the editor to execute the specified macro 
without first checking to see if a subcommand of the same name or a synonym 
exists. 

2. The MACRO subcommand must be used when the macro name contains 
non-alphabetic characters. It does not follow the usual parsing rule of 
separating alphabetic characters from immediately following non-alphabetic 
characters. For example, N2 usually means NEXT 2. MACRO N2 means 
"execute the macro named N2." 



The response, if any, from the executed macro is displayed. 



542E No such subcommand: name [RC = -l] 



— 1 No such subcommand 

nn Return code of the macro specified as operand 
Normal 
6 Subcommand rejected in the profile due to LOAD error, or QUIT 

subcommand has been issued in a macro called from the last file in the ring 



1. macro N ABC 

invokes the macro file N XEDIT with the argument ABC. 

2. macro N2 ABC 

invokes the macro file N2 XEDIT with the argument ABC. 
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MERGE 



MERGE 



Format 



Operands 



Use the MERGE subcommand to combine two sets of lines. The first set of Unes is 
deleted and the second set is modified in place. 




targetl 

defines the number of lines to be merged, starting with the current line up to, but 
not including, targetl . Targetl defines the first group of lines that you wish to 
merge with a second group of lines. 

A target may be specified as an absolute line number, a relative displacement 
from the current Une, a Une name, or a string expression. For more information 
on targets, refer to the LOCATE subcommand in this book and to the 
pubUcation, VM/SP System Product Editor User's Guide. 

target2 

defines the beginning of the second group of lines that is to be merged with the 
first. 



col 



specifies the column number to which column 1 of the first group of lines being 
merged is to be shifted. The first group is shifted to the right of the second 
group and then overlays the second group. This allows the merger of two 
columns of data, side by side. The default "col" is 1 . 



Usage Notes 



1 . MERGE shifts the first group of lines and then overlays the second group of 
lines. It is similar in function to the OVERLAY subcommand, except that 
MERGE does not give special treatment to underscore characters. 

2. Following the MERGE with the second set of lines, the first set of hnes is 
deleted. The lines can be recovered by using the RECOVER subcommand. 

3. The first group of Hnes cannot overlap the second group of Unes. 

4. If SET SPILL OFF is in effect (the default), characters that have been pushed 
beyond the truncation column are truncated. If SET SPILL ON or SET SPILL 
WORD has been issued, characters that have been pushed beyond the truncation 
column are inserted in the file as one or more new lines, starting with the first 
character or word that would have gone beyond the truncation column. 
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MERGE 



Response 
Messages 



5. When combining two lines, the merge handles blanks as follows: 



First line 


Second 1 


ine 


Result line 


blank 


blank 




blank 


X 


blank 




X 


blank 


y 




y 


X 


y 




X 



Return Codes 



where 'First line' designates any of the lines in the group starting at the current 
line, and 'Second line' designates any of the lines in the group starting at the 
second target parameter. The blank columns of the line to be modified are 
replaced with the corresponding columns from the Une in the first merge group; 
however, blanks in the first merge group do not replace character data in the 
Une to be modified. 



The last line merged becomes the new current line. 



498E Not executed—the two areas to merge overlap each other [RC = 1] 

520E Invalid operand: operand [RC = 5] 

527E InvaUd column number [RC = 1] 

543 E Invalid number: number [RC = 5] 

545E Missing operand(s) [RC = 5] 

546E Target not found [RC = 2] 

58 IE Subcommand is not vaUd in extended mode [RC = 3] 

593E {Noi««} lines merged, nn Une(s) {truncated! spilled} [RC = 3] 



Normal 

1 Overlapping groups of lines; invalid column number 

2 Target line not found 

3 Truncated or spilled, or subcommand is not valid in extended mode 

5 Missing or invalid operand or number 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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MERGE 



Examples 



Figure 9 is a before-and-after example of the MERGE 



subcommand. 



DESSERT COOKBOOK Al F 80 Trunc=80 Si2e=15 Li 

00000 * * * Top of File * * * 

00001 CREAM PUFFS 
00002 

00003 2 OUNCES BUTTER 

00004 1/2 TEASPOON SUGAR 

00005 1/2 CUP FLOUR 

00006 1 PINCH OF SALT 

00007 2 EGGS 

00008 2 CUPS HEAVy CREAM, WHIPPED 

00009 CHOCOLATE SAUCE 

'••• + •••.1.... + ... 2 + :} ^ y, 

00010 •••^••••+••••3... .+....4... 

00011 12 
2 
1 
2 



ne=9 Col=l Alt=0 



00012 
00013 
00014 
00015 
00016 * * * End of File 



OUNCES SEMI -SWEET CHOCOLATE 
OUNCES UNSWEETENED CHOCOLATE 
CUP HEAVY CREAM 
OUNCES COGNAC 



--> merge :15 -/PUFFS/ 35 























































X E D I 


r 1 1 


-ilp 



DESSERT COOKBOOK Al F 80 Trunc=80 Size-9 Li 



merged 



ne=6 Col=l Alt=l 



00000 * * * Top of File * * 

00001 CREAM PUFFS 
00002 

2 OUNCES BUTTER 
1/2 TEASPOON SUGAR 
1/2 CUP FLOUR 
1 PINCH OF SALT 
!•••+•■..!....+.. 7 



CHOCOLATE SAUCE 



00003 
00004 
00005 
00006 



12 
2 
1 
2 



OUNCES SEMI-SWEET CHOCOLATE 
OUNCES UNSWEETENED CHOCOLATE 
CUP HEAVY CREAM 
OUNCES COGNAC 



00007 2 EGGS 

00009 ^ ^^'^ "^'^^^ ^^^^^^' ^"^fPED 

00010 * * * End of File * * * 











































































> 


: E D I T 


1 File 



Figure 9. The MERGE Subcommand - Before 



and After 
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MODIFY 



MODIFY (Macro) 



Use the MODIFY macro to display a subcommand and its current operand values 
in the command Une, so that a new operand value can be typed over the current one 
and the subcommand immediately reentered. 



Format 




Operand 



keyword 

is one of the following keyword operands valid with the SET, QUERY, 
EXTRACT, or TRANSFER subcommands: 



ALT 


HEX 


SCReen 


APL 


I Mage 


SELect 


ARBchar 


IMPcmscp 


SERial 


AUtosave 


LASTLorc 


SHADOW 


BRKkey 


LINENd 


SIDcode 


CASE 


LRecl 


SPAN 


CMDline 


MACRO 


SPILL 


*COLOR field 


MASK 


STAY 


COLPtr 


MSGLine 


STReam 


column 


MSGMode 


SYNonym 


CTLchar [char] 


NONDisp 


TABLine 


CURLine 


NULls 


TABS 


Display 


NUMber 


TERMinal 


ENTer 


PAn 


TEXT 


Escape 


PACK 


TOFEOF 


ETARBCH 


PFn 


TRunc 


ETMODE 


PREfix [Synonym 


name] VARblank 


Filler 


RANge 


Veri fy 


FMode 


RECFm 


VERShift 


FName 


REMOte 


WRap 


FType 


SCALe 


Zone 


FULLread 


SCOPE 





Refer to the SET COLOR subcommand in this publication for a list of the fields. 
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MODIFY 



Usage Notes 



Response 



Messages 



Return Codes 



Examples 



1. All of the above keywords cause the corresponding SET subcommand and its 
current operand value to be displayed, except for the foUovi'ing: 

modify column 

displays CLOCATE :nn, where: nn is the current column, 
modify mask 

displays the current mask, so that you can type over it to modify it. 
modify synonym 

displays SET SYNONYM ON or SET SYNONYM OFF. 

2. MODIFY CTLCHAR can be specified only when no control characters are 
defined. Otherwise, specify MODIFY CTLCHAR char. 



If the keyword specified is unknown or is an XEDIT variable that cannot be 
modified, an error message is displayed. 



520E Invalid operand: operand [RC = 5] 

529E Subcommand is only valid in {display|editing} mode [RC = 3] 

545E Missing operand(s) [RC = 5] 



Normal 

3 Subcommand valid only in display mode 

5 Invalid or missing operand(s) 

6 Subcommand rejected in the PROFILE due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 



1. mod zone 
displays 

SET ZONE 5 25 

You can type over the "25" and change it to "50." Then press the ENTER key. 
The new zone settings will be 5 and 50. 

2. mod nulls 
displays 

SET NULLS OFF 

Type "ON" - to set NULLS ON. 
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MOVE 



MOVE 



Format 



Operands 



Responses 



Messages 



Return Codes 



Use the MOVE subcommand to move one or more lines, beginning with the current 
line, to a specified position in the file. The original lines are deleted. 




targetl 

defines the number of Unes to be moved. The lines are removed from the file 
starting with the current line up to, but not including, targetl. 

A target may be specified as an absolute line number, a relative displacement 
from the current Une, a line name, or a string expression. For more information 
on targets, refer to the LOCATE subcommand in this book and to the VM/SP 
System Product Editor User's Guide. 

targetl 

defines the destination hne. The data is moved after targe t2. 



The last line moved becomes the new current line. 
The editor displays the following message: 

5061 nn lines moved 



505E Not executed— the target line {nn) is within the lines to move [RC= 1] 

520E Invahd operand: operand [RC = 5] 

545E Missing operand(s) [RC = 5] 

546E Target not found [RC = 2] 



Normal 

1 Target line within the lines to move 

2 Target line not found 

5 Invalid or missing operands 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the rinj 
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MOVE 



Examples 

Figure 10 is a before-and-after example of the MOVE subcommand. 



ANIMALS FACTS Al V 8G Trunc=80 Size=28 Line=22 Col=l Alt=0 

===== THE ARMADILLO IS THE ONLY ARMORED MAMMAL. 

===== THE LION ROARS TO ANNOUNCE POSSESSION OF A PROPERTY. 

===== THE KILLER WHALE EATS DOLPHINS, PORPOISES, SEALS, PENGUINS, AND 

===== SQUID. 

===== ALTHOUGH PORCUPINE FISHES BLOW THEMSELVES UP AND ERECT THEIR SPINES. 

===== THEY ARE SOMETIMES EATEN BY SHARKS. NO ONE KNOWS WHAT EFFECT THIS 

===== HAS ON THE SHARKS. 

===== A FISH CALLED THE NORTHERN SEA ROBIN MAKES NOISES LIKE A WET 

===== FINGER DRAWN ACROSS AN INFLATED BALLOON. 

===== THE BOOKLOUSE CAN BE FOUND IN OLD BOOKS. IT FEEDS ON THE GLUE OF THE 

I... +....!.... +....2..,. +....3.... +....4.... +....5.... +....6.... +....7. 
===== BINDINGS AND ON MOLDS THAT GROW ON OLD PAPER. 

STINGAREES. FISH FOUND IN AUSTRALIA, CAN WEIGH UP TO 800 POUNDS 

===== AND HAVE THE MOST POTENT VENOM OF ALL FISH. 

===== OSTRICHES CAN KICK LIKE A MULE, IMITATE A LION'S ROAR, AND HISS LIKE 

===== A SNAKE. 

===== A QUEEN ANT CAN LIVE UP TO 15 YEARS. 

===== * * * End of File * * * 



===> move 2 -/SQUID/ 

X E D I T 1 File 



ANIMALS FACTS Al V 80 Trunc=80 Size=28 Line=18 Col=l Alt=l 
2 lines moved 

===== A LIZARD OF CENTRAL AMERICA CALLED THE BASILISK CAN RUN 
===== ACROSS WATER. 

===== OCTOPI HAVE LARGE BRAINS AND SHOW CONSIDERABLE CAPACITY FOR 
===== LEARNING. 

===== THE ARMADILLO IS THE ONLY ARMORED MAMMAL. 
===== THE LION ROARS TO ANNOUNCE POSSESSION OF A PROPERTY. 
===== THE KILLER WHALE EATS DOLPHINS, PORPOISES, SEALS, PENGUINS, AND 
===== SQUID. 

===== THE BOOKLOUSE CAN BE FOUND IN OLD BOOKS. IT FEEDS ON THE GLUE OF THE 
===== BINDINGS AND ON MOLDS THAT GROW ON OLD PAPER. 

|...+....l....+....2....+....3....+....4...,+....5....+....6....+....7. 
===== ALTHOUGH PORCUPINE FISHES BLOW THEMSELVES UP AND ERECT THEIR SPINES, 
===== THEY ARE SOMETIMES EATEN BY SHARKS. NO ONE KNOWS WHAT EFFECT THIS 
===== HAS ON THE SHARKS. 

===== A FISH CALLED THE NORTHERN SEA ROBIN MAKES NOISES LIKE A WET 
===== FINGER DRAWN ACROSS AN INFLATED BALLOON. 

===== STINGAREES, FISH FOUND IN AUSTRALIA. CAN WEIGH UP TO 800 POUNDS 
===== AND HAVE THE MOST POTENT VENOM OF ALL FISH. 
===== OSTRICHES CAN KICK LIKE A MULE, IMITATE A LION'S ROAR, AND HISS LIKE 



=== A SNAKE. 

:=> 



X E D I T 1 File 



Figure 10. The MOVE Subcommand — Before and After 
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MSG 



Format 



MSG 



Use the MSG subcommand to display a message in the message area of the logical 
screen. 




Operand 



text 



is the text of the message to be displayed, 
displayed. 



If omitted, a blank line will be 



Usage Notes 

1. The MSG subcommand does not sound the alarm. (Use the EMSG 
subcommand to sound the alarm.) 

2. MSG can also be used to type a message on a typewriter terminal. 

Notes for Macro Writers 

1. Use the MSG subcommand within a macro to display a message at the terminal. 

2. When multiple messages are issued and they do not fit on the message line(s) as 
defined by SET MSGLINE, they are passed to CMS. If full-screen CMS is 
OFF, the message replaces the file image on the screen and the terminal is 
placed in a "MORE..." (waiting) status. To get the file image back on the 
screen, press the CLEAR key. 

If full-screen CMS is ON, the message will appear in the CMSOUT window. To 
see all of the text in the virtual screen, you can use the CMS SCROLL 
command. The screen will be cleared automatically when you scroll to the 
bottom of the virtual screen. An alternative way to clear the screen is to issue 
the CMS DROP WINDOW command. If you have deleted the CMSOUT 
window, you won't see messages that are passed to CMS. 



Responses 
Return Codes 



The message is displayed in the message area of the screen. 



Normal 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 

subcommand has been issued in a macro called from the last file in the rim 
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NEXT 



NEXT 



Format 



Operand 



Usage Note 



Use the NEXT subcommand to advance the Hne pointer a specified number of lines 
toward the end of the file. The line pointed to becomes the new current line. (The 
NEXT subcommand is equivalent to the DOWN subcommand.) 




is the number of lines to move the line pointer. If you specify an asterisk (*), 
the line pointer moves to the "End of File" line. If you omit n, the pointer 
moves down only one line. 



The NEXT n subcommand is equivalent to a plus ( + ) target definition. 

For example: 
next 3 

is equivalent to 
+3 



Response 
Messages 

Return Codes 



Examples 



The line pointed to becomes the new current line. 



520E Invalid operand: operand [RC = 5] 
543E Invalid number: number [RC = 5] 



Normal 

1 End of file reached and displayed 

5 Invahd operand or number 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 



Figure 11 is the before-and-after example of the NEXT subcommand. 
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NEXT 



PURIST SCRIPT Al V 132 Trunc=132 S1ze=12 Line=5 Col=l Alt=0 



* * * Top of File * * * 
"THE PURIST" 

I GIVE YOU NOW PROFESSOR TWIST. 

A CONSCIENTIOUS SCIENTIST. 

TRUSTEES EXCLAIMED, "HE NEVER BUNGLES!" 

I... +....!.... +....2.... +....3.... +....4. 

AND SENT HIM OFF TO DISTANT JUNGLES. 

CAMPED ON A TROPIC RIVERSIDE, 

ONE DAY HE MISSED HIS LOVING BRIDE. 

SHE HAD, THE GUIDE INFORMED HIM LATER. 

BEEN EATEN BY AN ALLIGATOR. 

PROFESSOR TWIST COULD NOT BUT SMILE. 

"YOU MEAN." HE SAID. "A CROCODILE." 

* * * End of File * * * 



====> next 5 



X E D I T 1 File 



PURIST SCRIPT Al V 132 Trunc=132 Size=12 Line=10 Col=l Alt=0 

===== "THE PURIST" 

===== I GIVE YOU NOW PROFESSOR TWIST. 
===== A CONSCIENTIOUS SCIENTIST. 
===== TRUSTEES EXCLAIMED. "HE NEVER BUNGLES!" 
===== AND SENT HIM OFF TO DISTANT JUNGLES. 
===== CAMPED ON A TROPIC RIVERSIDE. 
===== ONE DAY HE MISSED HIS LOVING BRIDE. 
===== SHE HAD, THE GUIDE INFORMED HIM LATER. 
===== BEEN EATEN BY AN ALLIGATOR. 

I... + 1 + 2 + 3 + 4 + 5 + 6.. 

===== PROFESSOR TWIST COULD NOT BUT SMILE. 
===== "YOU MEAN." HE SAID, "A CROCODILE." 
===== * * * End of File * * * 



X E D I T 1 File 



Figure 1 1 . The NEXT Subcommand — Before and After 
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NFIND 



NFIND 



Format 



Operand 



Use the NFIND subcommand to search forward in the file for the first Une that does 
not start with the text specified in the operand. The search starts with the hne 
following the current line. 




text 



is any text that you do not want to find, beginning in column one of the next file 
line. Only the non-blank characters in the operand are checked against the file. 



Usage Notes 



1. Only one blank can be used as a dehmiter following the NFIND subcommand. 

2. If a SET IMAGE ON subcommand is in effect, tabs in the operand are changed 
to blanks (or filler characters) before the search is made. In addition, the search 
begins in the first tab column. 

3. Use an underscore character ( _ ) in the operand to designate that a blank 
character should appear in the line. 

4. See also FIND, FINDUP, NFINDUP. 

5. If the subcommand SET WRAP OFF has been issued, the search will continue 
until the end of file. 

If the subcommand SET WRAP ON has been issued, the search will continue 
through the entire file and stop when the Une where it started is reached again. 
When a WRAP occurs under these conditions, the following warning message is 
displayed: 

592W Wrapped 



Response 
Messages 



6. The NFIND subcommand updates the LASTLORC buffer. Refer to the SET 
LASTLORC subcommand in this pubUcation. 



The first hne that does not match the operand becomes the new current Une. 



545E Missing operand(s) [RC = 5] 
586E Not found [RC = 2] 
592W Wrapped .... 
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NFIND 



Return Codes 

Normal 

2 No target line was found 

5 Missing operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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NFINDUP 



NFINDUP 



Format 



Operand 



Usage Notes 



Use the NFINDUP subcommand to search backward in the file for the first Une that 
does not start with the text specified in the operand. The search starts with the Une 
preceding the current Hne. 




text 



is any text that you do not want to find, beginning in column one of the file Hne 
preceding the current line. Only the non-blank characters in the operand are 
checked against the file. 



1 . Only one blank can be used as a deUmiter following the NFINDUP 
subcommand. 

2. If a SET IMAGE ON subcommand is in effect, tabs in the operand are changed 
to blanks (or filler characters) before the search is made. In addition, the search 
begins in the first tab column. 

3. Use an underscore character ( _ ) in the operand to designate that a blank 
character should appear in the line. 

4. See also FIND, FINDUP, NFIND. 

5. If the subcommand SET WRAP OFF has been issued, the search will continue 
until the top of file. 

If the subcommand SET WRAP ON has been issued, the search will continue 
through the entire file and stop when the line where it started is reached again. 
When a WRAP occurs under these conditions, the following warning message is 
displayed: 

592W Wrapped 



Response 
Messages 



6. The NFINDUP subcommand updates the LASTLORC buffer. Refer to the 
SET LASTLORC subcommand in this pubhcation. 



The first line that does not match the operand becomes the new current line. 



545E Missing operand(s) [RC = 5] 
586E Not found [RC = 2] 
592W Wrapped .... 
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NFINDUP 



Return Codes 

Normal 

2 No target line was found 

5 Missing operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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OVERLAY 



OVERLAY 



Format 



Operand 



Use the OVERLAY subcommand to replace selectively one or more characters in 
the current line with the corresponding nonblank characters in the line being keyed 
in. If SET IMAGE ON is in effect, replacement starts at the first tab column of the 
current line. 




text 



specifies an input line that replaces corresponding character positions in the 
current line. 



Usage Notes 



1 . Blank characters in the input line indicate that the corresponding characters in 
the current line are not to be overlaid. 

2. Use an underscore character ( _ ) in the input line to place a blank in the 
corresponding character position in the current line. 

3. Use the C REPLACE subcommand instead of the OVERLAY subcommand 
when you want a one-for-one replacement of blanks and underscore characters. 

4. At least one blank must follow the OVERLAY subcommand; the operand starts 
after the first blank that follows the subcommand name (or its abbreviation). 

5. If SET IMAGE ON is in effect, tabs in the text operand are expanded to blank 
(or filler) characters. These blanks will also leave the corresponding characters 
in the current Une unchanged. 

For example, the following subcommand adds a comment to an assembler 
language statement (file type ASSEMBLE) whose settings are defined by SET 
TABS 1 10 16 30 35 ... : 

overl ayTTTTcomment 

(where T represents a tab character) 

6. If SET SPILL OFF is in effect (the default), characters that have been pushed 
beyond the truncation column are truncated. If SET SPILL ON or SET SPILL 
WORD has been issued, characters that have been pushed beyond the truncation 
column are inserted in the file as one or more new lines starting with the first 
character or word that would have gone beyond the truncation column. 



Messages 



503E {TruncatedlSpilled} [RC = 3] 

545E Missing operand(s) [RC = 5] 

58 IE Subcommand is not vaUd in extended mode [RC = 3] 

585E No hne(s) changed [RC = 4] 
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OVERLAY 



Return Codes 



Normal 

3 Truncated or spilled, or subcommand is not valid in extended mode 

4 No line(s) changed 

5 Missing operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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PARSE 



PARSE (Macro) 



Format 



Use the PARSE macro to help you write new XEDIT macros. The PARSE macro 
scans a line (of the new macro) that has been transmitted from the console stack to 
see if its operands match a format specified in the PARSE macro. 



PARSE 



startcol 



Alphaword 

Number 

String 

Dblstring 

Target 

Word 

Line 



Operands 



startcol 

specifies the starting column in the input line where the parsing is to begin. 

The following keywords define the sequence and types of the operands: 

Alphaword 

specifies that the operand must be an alphabetic character string. 

Number 

specifies that the operand must be a numeric character string. 

String 

specifies that the operand must be a delimited string; the deUmiter is the first 
character of the string. 

Dblstring 

specifies that the operand must be a double string, that is, two adjacent strings 
separated by a common delimiter. For example, /string l/string2/ is a double 
string. 

Target 

specifies that the operand must be an XEDIT target. 

Word 

specifies that the operand must be a character string, either alphabetic, numeric, 
or mixed, delimited by blanks. 

Line 

specifies the unprocessed part of the line being parsed. If the first character is a 
blank, it is excluded. 

Notes for Macro Writers 

I. Before issuing the PARSE macro, you must place the line to be parsed in the 
console stack. For example, 

push string 
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Return Codes 



PARSE 



2. As a result of the PARSE macro, several lines are stacked last-in first-out 
(LIFO) in the console stack: 

a. The first line contains an integer that indicates the number of stacked lines 
that follow. One line is stacked for each recognized operand in the parsed 
line and will be in the order they were specified. 

b. Each of the remaining lines contains the starting column and the length of 
the operand, except for STRING and DBLSTRING operands. 

A line stacked for a STRING operand contains: 

• the starting colimin of the delimited string 

• the length of the delimited string (including delimiters) 

• the starting column of the string itself (without the delimiter) 

• the length of the string (without deUmiters). 

A line stacked for a DBLSTRING operand contains: 

• the starting column of the delimited strings 

• the length of the delimited strings (including delimiters) 

• the starting column of the first string itself (without the deUmiter) 

• the length of the first string (without delimiters) 

• the starting column of the second string (without the delimiter) 

• the length of the second string (without the delimiters). 

Note: For both STRING AND DBLSTRING operands, null strings 
(explicit or implicit as in // or /) are described as starting in column — 1 with 
a length of 0. 



- 1 The operands specified in the PARSE macro are incorrect, that is, the first 

operand is not a number, or one of the subsequent operands is not recognized. 
Nothing is stacked. 

Parsing was successful. 

1 The scanned line did not match the format specified in the PARSE macro. 
Parsing was incomplete. Results of the parsing that was completed are 
available from the console stack. 

5 Invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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POWERINP 



POWERINP 



Format 



Use the POWERINP (power input) subcommand to enter an input mode in which 
you can type data as if the screen were one long line. You do not have to be 
concerned with line length; you can start typing a word on one Une of the screen and 
finish it on the next. When the ENTER key is pressed, the editor divides the data 
into file lines and puts together any split words. 




Usage Notes 



1 . When POWERINP is executed, the current file line is displayed in the second 
line of the screen in protected format, that is, it cannot be modified. The rest of 
the screen is blank and can be used for input. 

2. You can type words continuously and fill up the screen as long as you don't 
press the ENTER key. When the ENTER key is pressed, the last input Une 
becomes the current line and is displayed at the top of the screen, and you can 
continue typing data. 

3. To exit from power input mode, press the ENTER key without modifying the 
last displayed screen. The editor divides the data you typed into appropriate file 
lines. If necessary, lines are cut at word boundaries and, when possible, the data 
is divided into lines that do not wrap. 

4. PF keys cannot be used in power input mode. (Pressing a PF key is equivalent 
to pressing the ENTER key.) Any prefix subcommands or macros are not 
executed until you exit from power input mode. 

5. If you want to cause a break in the data that you type in power input mode, 
that is, you want data to start on a new line (for example, a new paragraph or 
SCRIPT/VS control words, which must start in column one), you can type a line 
end character (see SET LINEND) before the data that you want to start on a 
new Une. The default line end character is a pound sign (#). 

For example, if the following data is typed in power typing mode: 

.sp#A pound sign causes the data to start on a new line.#.sp 

The data will be entered in the file as: 

===== .sp 

===== A pound sign causes the data to start on a new line. 

===== .sp 

Any leading blanks after the Une end character are eliminated when the data is 
entered in the file. The first non-blank character after the line end character is 
placed in column one. 

6. A word cannot be longer than the truncation setting. 

7. You can use the insert key to insert characters in a Une while in power input 
mode. When characters are inserted, the entire stream of data shifts to the right. 
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Response 



Messages 



Return Codes 



POWERINP 



8. Any prefix subcommands or macros are not executed until you exit from power 
input mode. 

9. If the width of your virtual screen or window is less than that of the physical 
screen, you won't be able to type continuously in power input mode. The 
keyboard will lock when you come to the end of a line. To unlock the 
keyboard, press the RESET key and return the cursor to start a new line. 



• In power input mode, the screen changes in the following ways: 

— The first line of the screen contains the file ID and the heading, 
fname ftype fmode ***Power Typing*** Alt=n 

— The second line of the screen contains the current file line in protected 
format. 

— The rest of the screen is blank. 



1 17S Error writing to display terminal [RC = 8] 

503E {TruncatedlSpilled} [RC = 3] 

529E Subcommand is only vahd in {display |editing} mode [RC = 3] 

557S No more storage to insert lines [RC = 4] 

58 IE Subcommand is not valid in extended mode [RC = 3] 



Normal 

3 Truncated or spilled; subcommand valid only for display terminal, or 
subcommand is not valid in extended mode 

4 Insufficient storage available 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 

subcommand has been issued in a macro called from the last file in the ring 
8 I/O error 
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PRESERVE 



PRESERVE 



Format 



Use the PRESERVE subcommand to save the settings of various XEDIT variables 
until a subsequent RESTORE subcommand is issued. 




Usage Notes 



1 . The following settings are saved: 

a. Current LEFT or RIGHT 

b. The following SET subcommand options: 



ARBCHAR 


IMPCMSCP 


SHADOW 


AUTOSAVE 


LASTLORC 


SPAN 


CASE 


LINEND 


SPILL 


CMDLINE 


LRECL 


STAY 


COLOR 


MACRO 


STREAM 


COLPTR 


MASK 


SYNONYM 


CURLINE 


MSGMODE 


TABLINE 


DISPLAY 


NULLS 


TABS 


ESCAPE 


NUMBER 


TOFEOF 


ETARBCH 


PACK 


TRUNC 


FILLER 


PREFIX 


VARBLANK 


FMODE 


RECFM 


VERIFY 


FNAME 


SCALE 


WRAP 


FTYPE 


SCOPE 


ZONE 


HEX 


SERIAL 


= 


IMAGE 







Message 
Return Codes 



2. The following values are not saved: 

Current line pointer 

Column pointer 

All SET subcommand options not listed above in Usage Note lb. 



520E Invalid operand: operand [RC = 5] 



Normal 

5 Invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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PURGE 



PURGE 



Format 



Operand 



Usage Notes 



Messages 



Return Codes 



Use the PURGE subcommand to remove the copy of a macro that is in virtual 
storage. 




macroname 

is the name of a macro, a copy of which is in virtual storage. 



1 . When a macro is used for the first time in an editing session, the editor 
EXECLOADs the macro into virtual storage. The macro remains in storage for 
the entire session. The macros which the editor has EXECLOADed are 
EXECDROPed at the end of the session. (When storage becomes unavailable, 
the copy of the least-recently used macro is erased.) The PURGE subcommand 
is useful if you modify a macro and want the editor to read the new macro from 
disk or directory. 

Any time a macro that is being edited is filed or saved, an automatic PURGE is 
executed for that macro name. Therefore, PURGE is useful only after the CMS 
commands RENAME or DISK LOAD or with disk operations performed 
outside XEDIT. 

2. When a macro invokes the PURGE subcommand and the PURGE is 
successfully completed, the return code is set to zero. If the macro to be purged 
is not in storage, the return code is set to 3. If the macro to be purged is in use, 
the return code is set to 4 and the macro is not purged. 



520E Invalid operand: operand [RC = 5] 

545E Missing operand(s) [RC = 5] 

578W macroname macro is not currently in storage [RC = 3] 



Normal 

3 Macro is not currently in storage 

4 Macro is in use, do not purge 

5 Missing or invaUd operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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PUT 



PUT 



Format 



Use the PUT subcommand to insert one or more lines from the file being edited, 
starting with the current line, into one of the following: the end of a specified 
existing file; a new file that you are creating; or a temporary file created by the 
editor. The original hnes remain in the file you are editing. 



PUT 




target 
1 


'fn 


'ft 


'fm\ 


• 1 



Operands 



target 

defines the number of lines to be inserted into another file. Lines are inserted 
beginning with the current line, up to but not including the target line. If you 
enter an asterisk (*), the rest of the file is inserted. If you omit target, only the 
current Une is inserted. 

A target may be specified as an absolute Une number, a relative displacement 
from the current line, a line name, or a string expression. For more information 
on targets, refer to the LOCATE subconmiand in this book and to the 
pubhcation VM/SF System Product Editor User's Guide. 



fn 



ft 



fm 



is the file name of the file into which lines are to be inserted. If the file does not 
exist, the editor creates it and displays the message. Creating new file, in the 
message area. 



is the file type of the file into which lines are to be inserted, 
editor uses the file type of the file you are currently editing. 



If you omit ft, the 



is the file mode of the file into which Unes are to be inserted. If you omit fm, 
the editor uses the file mode of the file you are currently editing. 



Usage Notes 



1. The operands fn, ft, or fm may be specified by an equal sign (=^), in which case 
the corresponding value of the file currently being edited is used. 

2. If the specified file (fn ft fm) exists, the lines are added to the end of the file. If 
the file is in an SFS directory, you must have write authority to the file and the 
directory must be accessed either read/only or read/write. 

3. If the specified file (fn ft fm) does not already exist, the editor creates it and 
inserts the lines. If the file mode indicates an SFS directory, you must have 
write authority to the directory and it must be accessed either read/only or 
read/write. 

4. If you do not specify a file ID (fn ft fm), the Unes specified by target are inserted 
into a temporary file that the editor creates. These Unes can be retrieved each 
time a subsequent GET subcommand is issued without an operand. This 
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PUT 



temporary file is replaced each time a PUT (or PUTD) subcommand is issued. 
It is erased when XEDIT returns control to the environment which invoked the 
editor. Thus, issuing a PUT subcommand without specifying a file ID is Uke 
storing lines in a temporary holding area. You can retrieve the temporary file 
without knowing its file ID. 

5. If you issue a PUT subcommand without any operands, only the current line is 
placed in a temporary file. 

6. When you are editing multiple files, only one temporary file is available. It may 
be used to insert data from one file into another. 



Responses 



1. If you are creating a file with the PUT subcommand, the following message is 
displayed. 



Messages 



Return Codes 



5711 Creating new file: 

2. The line following the last line PUT (the target line) becomes the new current 
line. 



037E 
048E 
062E 
069E 
105S 

229E 
520E 
531E 
546E 

554E 

5711 

579E 

698W 

1138E 

1141W 

1215E 
1258E 
1262S 
1301S 



Filemode mode is accessed as read/only [RC = 12] 

InvaUd filemode mode [RC = 24] 

Invalid character in fileid fn ft fm [RC = 20] 

Filemode mode not accessed [RC = 36] 

Error nn writing mefnftfm to disk [RC = 55, 70, 76, 99, or 100] 

Unsupported OS data set, error nn [RC = 80, 81, 82, 83, or 84] 

InvaUd operand: operand [RC = 5] 

Disk or file space is full; set new filemode or clear some space [RC ■■ 

Target not found [RC = 2] 

Not enough virtual storage available [RC= 104] 



13] 



Creating new file: 

Records truncated to nn when added to fn ft fm [RC = 3] 

New record length may result in loss of double-byte characters [RC = 3] 

File sharing conflict for file fn ft fm [RC = 70] 

User filespace threshold exceeded 

File fn ft fm is locked by another user [RC = 70] 

Not authorized to write Giefnftfm [RC = 12] 

Error nn opening file fn ft fm [RC = 55, 70, 76, 99, or 100] 

Rollback error nn, file fn ft fm left open 



Normal 

1 TOF or EOF reached 

2 Target not found 

3 Records truncated 

5 Invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the rin^ 

12 Minidisk is read-only or not authorized 

13 Minidisk or file space is full 

20 InvaUd character in file name or file type 

24 InvaUd file mode 
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PUT 



Examples 



36 Corresponding minidisk or directory not accessed 

55 APPC/VM communications error 

70 File sharing conflict 

76 Connection error 

80 An I/O error occurred while an OS data set or DOS file was being read or an 
OS or DOS disk was detached without being released. 

81 The file is an OS read-password-protected data set or a DOS file with the input 
security indicator on. 

82 The OS data set or DOS file is not BPAM, BSAM, or QSAM. 

83 The OS data set or DOS file has more than 16 user labels or data extents. 

84 Unsupported OS data set 

99 A required system resource is not available 

100 Error writing file to disk 
104 Insufficient virtual storage 



The following are valid ways to issue the PUT subcommand: 

put 

(store current Hne in temporary file, to be inserted by subsequent GET in 
another file) 

put/string/ 

(store from current line up to the line containing string, for use by a 
subsequent GET in another file) 

put /string/ MY NEWFILE 

(create a new file with lines from current line up to the string) 

Refer to the "Examples" section of the GET subcommand for an example of how to 
use PUT and GET to transfer lines between files while editing multiple files. 
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PUTD 



Format 



PUTD 



Use the PUTD subcommand to insert one or more lines from the file being edited, 
starting with the current line, into one of the following: the end of a specified 
existing file; a new file that you are creating; or a temporary file created by the 
editor. 

Unlike the PUT subcommand, the PUTD subconmiand deletes the original Unes 
from the file you are editing. 



PUTD 




target 
1 


'fn 


'ft 


'fml 


■ 1 



Operands 



target 

defines the number of lines to be inserted into another file. Lines are inserted 
beginning with the current line, up to but not including the target line. If you 
enter an asterisk (*), the rest of the file is inserted. If you omit target, only the 
current line is inserted. 

A target may be specified as an absolute line number, a relative displacement 
from the current line, a line name, or a string expression. For more information 
on targets, refer to the LOCATE subcommand in this book and to the 
publication VMjSP System Product Editor User's Guide. 



fn 



ft 



fm 



is the file name of the file into which lines are to be inserted. If the file does not 
exist, the editor creates it and displays the message. Creating new file, in the 
message line. 

is the file type of the file into which lines are to be inserted. If you omit ft, the 
editor uses the file type of the file you are currently editing. 

is the file mode of the file into which lines are to be inserted. If you omit fm, 
the editor uses the file mode of the file you are currently editing. 



Usage Note 



The PUTD subcommand, unlike the PUT subcommand, deletes the original lines 
from the file. 

For additional information, please refer to the "Usage Notes" section of the PUT 
subcommand. 
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PUTD 



Responses 



If you are creating a file with the PUTD subcommand, the following message is 
displayed: 



Messages 



Return Codes 



5711 Creating new file: 

After lines are deleted from the original file, the line immediately following the last 
line deleted becomes the new current line. If lines are deleted in a backward 
direction, toward the top of the file, the line preceding the last deleted Une becomes 
the new current line. 



037E Filemode mode is accessed as read/only [RC == 12] 

048E InvaHd filemode mode [RC = 24] 

062E Invalid character in fileid fn ft fm [RC = 20] 

069E Filemode mode not accessed [RC = 36] 

105S Error nn writing niefnftfm to disk [RC = 55, 70, 76, 99, or 100] 

229E Unsupported OS data set, error mi [RC = 80, 81, 82, 83, or 84] 

520E InvaUd operand: operand [RC = 5] 

53 IE Disk or file space is full; set new filemode or clear some space [RC = 13] 

546E Target not found [RC = 2] 

554E Not enough virtual storage available [RC = 104] 

559W Warning: file is empty [RC = 1] 

5711 Creating new file: 

579E Records truncated to nn when added to fn ft fm [RC = 3] 

698 W New record length may result in loss of double-byte characters [RC = 3] 

1 1 38E File sharing conflict for file fn ft fm [RC = 70] 

1141W User filespace threshold exceeded 

12 1 5E File fn ft fm is locked by another user [RC = 70] 

1 258E Not authorized to write file fn ft fm [RC = 1 2] 

1262S Error nn opening file fn ft fm [RC = 55, 70, 76, 99, or 100] 

130 IS Rollback error nn, file fn ft fm left open 



Normal 

1 TOF or EOF reached 

2 Target not found 

3 Records truncated 

5 Invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 

12 Minidisk is read-only or not authorized 

13 Minidisk or file space is full 

20 InvaUd character in file name or file type 

24 Invalid file mode 

36 Corresponding minidisk or directory not accessed 

55 APPC/VM communications error 

70 File sharing conflict 

76 Connection error 

80 An I/O error occurred while an OS data set or DOS file was being read or an 
OS or DOS disk was detached without being released. 



160 VM/SP System Product Editor Command and Macro Reference 



Examples 



PUTD 



81 The file is an OS read-password-protected data set or a DOS file with the input 
security indicator on. 

82 The OS data set or DOS file is not BPAM, BSAM, or QSAM. 

83 The OS data set or DOS file has more than 16 user labels or data extents. 

84 Unsupported OS data set 

99 A required system resource is not available 

100 Error writing file to disk 
104 Insufficient virtual storage 



See the "Examples" section of the PUT subcommand. 
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QUERY 



QUERY 



Format 



Use the QUERY subcommand to display in the message area the current setting of 
various editing options. Only one option may be specified in each QUERY 
subcommand. 



Query 


ACTion 


NONDisp 






ALT 


NULls 






APL 
ARBchar 


NUMber 

PAlrel*. 






AUtosave 


PACK 






BASEft 


PENDing [block ]fc>LDNAME] name 

PF[n\*j 

Point i*J 

PREfix [ Synonym * | name . 


1* 




BRKkey 






CASE 






CMDline 






COLOR* {field 


RANge 






COLPtr 


RECFm 






COLumn 


REMOte 






CTLchar [char 


RESERved 






CURLine 


RING 






CURSor 


SCALe 






Display 


SCOPE 






EDIRName 


SCReen 






EFMode 


SELect 






EFName 


Seq8 






EFType 


SERial 






ENTer 


SHADOW 






EOF 


SIDcode 






EOL 


SIZe 






ESCape 


SPAN 






ETARBCH 


SPILL 






ETMODE 


STAY 






FILler 


STReam |- -, 
SYNonym [*\name. 






FMode 






FName 


TABLine 






FType 


TABS 






FULLread 


TARGet 






HEX 


TERMinal 






IMage 


TEXT 






IMPcmscp 


TOF 






LASTLorc 


TOFEOF 






LASTmsg 


TOL 






LENgth 


TRANSLat 






LIBName 


TRunc 






LIBType 


UNIQueid 






Line 


UNTil 






LINENd 


UPDate 






LRecl 


VARblank 






LScreen 


Verify 






MACRO 


VERShift 






MASK 


Width 






MEMber 


WRap 






MSGLine 


Zone 






MSGMode 


= 






NBFile 
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Operands 



QUERY 



ACTion 

displays "ON" or "OFF" to indicate whether any action other than displaying 
or scrolling has been taken on this file. This includes any file ID change, or file 
characteristic change (LRECL, RECFM, PACK, SERIAL, SIDCODE, or ALT) 

as well as any other changes made to the file. 

ALT 

displays the number of alterations that have been made to the file since the last 
AUTOSAVE and SAVE, or as specified in the SET ALT subcommand. 

APL 

displays "ON" or "OFF" as defined by the SET APL subcommand. 

ARBchar 

displays "ON" or "OFF" and the arbitrary character specified in the SET 
ARBCHAR subcommand. 

AUtosave 

displays the current setting defined in the SET AUTOSAVE subcommand: the 
AUTOSAVE count, file ID, and number of alterations. 

BASEft 

displays the base file type specified in the LOAD subcommand or the XEDIT 
command (where the LOAD is implicit). 

BRKkey 

returns "ON" or "OFF" as defined by the terminal brkkey setting. If ON, then 
it also returns the PF or PA key currently set to be the BRKKEY. 

CASE 

displays the case setting "U" or "M" and "R" or "I" as defined in the SET 
CASE subcommand. 

CMDline 

displays "ON", "OFF", "TOP", or "BOTTOM" as defined by the SET 
CMDLINE subcommand. 

COLOR * [field 

displays the current setting defined in the SET COLOR subcommand: field, 
color, extended highlighting, "HIGH" or "NOHIGH," and programmed symbol 
set for the field requested or for all fields (* is specified). The fields which may 
be specified are: Arrow, Cmdline, CUrline, Filearea, Idhne, MsgUne, Pending, 
PRefix, Scale, SHadow, STatarea, Tabline, and TOfeof. 

COLPtr 

displays "ON" or "OFF" as defined by the SET COLPTR subcommand. 
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QUERY 



COLumn 

displays the column number of the column pointer. 

CTLchar [char] 

If no character is specified (Q CTLCHAR), displays the escape character and 
all control characters defined by the SET CTLCHAR subcommand, in the form 
"CTLCHAR ON ESCAPE char CTL cl c2 c3 c4...." If no control characters 
have been defined, displays "CTLCHAR OFF." 

If a character is specified (Q CTLCHAR char), the attributes of that character 
are displayed, in the form "CTLCHAR char attribute 1 
(PROTECTINOPROTECT), attribute2 (color), attributes (extended 
highUghting), attribute4 (HIGH|NOHIGH|INVISIBLE), attributes (PSs)." If no 
attributes were defined for the character, displays "CTLCHAR char." 

CURLine 

displays the line number of the current Une as specified by the SET CURLINE 
subcommand. 

CURSor 

displays the current position of the cursor on the screen (line number and 
column number), and the position of the cursor in the file (Une number and 
column number). If the cursor is not in the file area, two negative numbers 
(—1) are displayed for the position of the cursor in the file. The top and bottom 
of the range are considered to be in the file. 

The current position of the cursor is the location where the cursor would be 
placed if the screen were displayed at this time. The current position reflects 
relative changes due to additions/deletions of Unes resulting from prefix 
execution. It does not necessarily reflect where the cursor will eventually be 
located when the screen is actually displayed. This is because cursor priority 
cannot be resolved until the screen is displayed. 

Display 

displays the range of selection levels which are included in the display, as 
specified by the SET DISPLAY subcommand. 

EDIRName 

displays the name of the SFS directory containing the file at the time the file was 
first loaded. 

EFMode 

displays the two-character file mode of the file at the time the file was first 
loaded. 

EFName 

displays the eight-character file name of the file at the time the file was first 
loaded. 

EFType 

displays the eight-character file type of the file at the time the file was first 
loaded. 
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ENTer 

displays "BEFORE", "AFTER", "ONLY", or "IGNORE" and the ENTER key 
definition as set by the SET ENTER subcommand. 

EOF 

displays "ON" or "OFF" as determined by the editor. EOF is "ON" when the 
hne pointer reaches end of file (or end of range). 

EOL 

displays "ON" or "OFF" as determined by the editor. EOL is "ON" when the 
column pointer reaches zone2 + 1 . 

Escape 

displays "ON" or "OFF" and the escape character defined by the SET ESCAPE 
subcommand. 

ETARBCH 

displays "ON" or "OFF" and the extended arbitrary character defined by the 
SET ETARBCH subcommand. 

ETMODE 

displays "ON" or "OFF" as defined by the SET ETMODE subcommand. 

FILler 

displays the filler character defined by the SET FILLER subcommand. 

FMode 

displays the two-character file mode. 

FName 

displays the eight-character file name. 

FType 

displays the eight-character file type. 

FULLread 

displays "ON" or "OFF" as defined by the SET FULLREAD subcommand. 

HEX 

displays "ON" or "OFF" as specified in the SET HEX subcommand. 

IMage 

displays "ON," "OFF," or "CANON" as specified in the SET IMAGE 
subcommand. 

IMPcmscp 

displays "ON" or "OFF" as specified in the SET IMPCMSCP subcommand. 
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LASTLorc 

displays the current contents of the last locate or change buffer, as specified 
either by SET LASTLORC or by the editor. 

LASTmsg 

displays the last message issued by the editor. This message may or may not 
have been displayed, depending on the SET MSGMODE subcommand 
operands. 

LENgth 

displays the length of the current line from column one through the truncation 
column (excluding traihng blanks). The length is zero for Top of File and End 
of File Unes. 

LIBName 

displays "LIBNAME filename" when MEMBER is ON. The file name is the 
library file name specified on the XEDIT or LOAD command. When 
MEMBER is OFF, the Ubrary file name is blank. 

LIBType 

displays "LIBTYPE filetype" when MEMBER is ON. The file type is the 
library file type specified on the XEDIT or LOAD command. When MEMBER 
is OFF, the Ubrary file type is blank. 

Line 

displays the current Une number, relative to the beginning of the file. 

LINENd 

displays "ON" or "OFF" and the Hne end character as defined by the SET 
LINEND subcommand. 

LRecl 

displays the logical record length of the file. 

LScreen 

displays six integers: 

• The number of lines and the number of columns in the logical screen 

• The hne number and the column number defining the top left corner of the 
logical screen on the virtual screen 

• The number of lines and number of columns in the virtual screen. 



MACRO 

displays "ON" or "OFF" as specified by the SET MACRO subcommand. 

MASK 

displays the current mask Hne as defined by the SET MASK subcommand. 
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MEMber 

displays "MEMBER ON" when editing a member of a CMS library or 
"MEMBER OFF" when not editing a Ubrary member. 

MSGLine 

displays "ON" or "OFF," the location of the message hne, the nmnber of Unes 
the message line can expand to, and OVERLAY, if that has been specified, as 
defined by the SET MSGLINE subcommand. 

MSGMode 

displays "ON" and "LONG" or "SHORT" as defined by the SET MSGMODE 
subcommand, or, if SET MSGMODE OFF has been issued, nothing is 
displayed. 

NBFile 

displays the number of files you are currently editing. 

NONDisp 

displays the character defined by the SET NONDISP subcommand. 

NULls 

displays "ON" or "OFF" as specified by the SET NULLS subcommand. 

NUMber 

displays "ON" or "OFF" as specified by the SET NUMBER subcommand. 

PA l«|ll 

displays "BEFORE," "AFTER," "ONLY," or "IGNORE" and: 

1 . If you specify an asterisk or no argument at all, QUERY PA displays all PA 
key definitions. 

2. If you specify a particular key (PAn), QUERY PA displays that key's 
setting. 

PACK 

displays "ON" or "OFF" as specified by the SET PACK subcommand. 

PENDing IBLOCKI [OLDNAMEl name\* 

displays the first entry in the pending hst with "name" name or all the entries in 
the pending list (if * specified). 

BLOCK 

indicates that the pending list is to be checked for BLOCK entries only. 

OLDNAME 

indicates that the name specified is the original name of the prefix subcommand 
or macro. 

name 

indicates the name of the prefix subcommand or macro for which you are 
searching. If OLDNAME is also specified, name must be the original name of 
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the prefix subcommand or macro, regardless of whether or not a synonym has 
been assigned to that name. Otherwise it is assumed to be a synonym (that is, a 
new name) or a name without a synonym. 



indicates to display all of the entries in the pending list. If BLOCK is also 
specified, * indicates to display only the block entries. 

The information is returned in the following form: 

Line n : 'name', 01dname='name' , OPl='x', 0P2='y', 0P3='z' 



PF [n\t] 

displays "BEFORE", "AFTER", "ONLY", or "IGNORE" and: 

1 . If you specify an asterisk or no argument at all, QUERY PF displays all PF 
key definitions. 

2. If you specify a particular key (PF«), QUERY PF displays that key's 
setting. 

Note: If you are editing a file in Une mode (SET TERMINAL 
TYPEWRITER), XEDIT does not recognize which key caused an attention 
interrupt. The definition which will be executed will be the CP definition of that 
key. To QUERY keys in hne mode, use the CP QUERY PF«« command. 

Point (*1 

QUERY POINT displays the symboUc name(s) associated with the current line, 
or displays a blank string if there are no names specified for this hne. QUERY 
POINT * displays all symboUc names that have been defined, starting at the top 
of the file including the line number to which each name applies. 

PREfix [Synonym *\name\ 

QUERY PREFIX displays "ON", "OFF", or "NULLS" and "RIGHT" or 
"LEFT" as specified in the SET PREFIX subcommand. 

QUERY PREFIX SYNONYM * displays both the old and the new names of 
the synonyms defined for the prefix subcommand(s) or macro(s). 

QUERY PREFIX SYNONYM name displays the synonym for the specified 
prefix subcommand or macro and its associated old name. 

RANge 

displays the line numbers of the top and bottom of the range defined by the SET 
RANGE subcommand. 



RECFm 

displays the record format, "F", "V", "FP", or "VP", defined by the SET 
RECFM subcommand. 

REMOte 

displays "ON" or "OFF" depending upon whether or not a remote terminal is 
being used or upon the setting specified by the SET REMOTE subcommand. 
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RESERved 

displays (on one line) the line numbers of the screen lines currently reserved. 
The line numbers are displayed in the order that they were reserved. 

RING 

displays the number of files you are editing and the file identification line for 
each file. 

The editor displays the following message: 
5301 nn file(s) in storage 

The following information is displayed for each file: 

fn ft fm recfm Irecl Trunc=truncno Size=sizeno 
Line=lineno Col=colno Alt=altcount 

where: 

fn 

is the file name of the file. 

ft 

is the file type of the file. 

fm 

is the file mode of the file. 

recfm 

is the record format. F is fixed-length records. V is variable-length 
records. FP is fixed-length packed. VP is variable length packed. 

Irecl 

the logical record length of the largest record permitted in the file. 

truncno 

is the truncation column. 

sizeno 

is the number of records currently in the file. 

lineno 

is the position in the file of the current Une. 

col no 

is the column number in which the column pointer is located. 

altcount 

is the number of alterations since the last autosave or the number set by 
SET ALT. 

SCALe 

displays "ON" or "OFF," and the position of the SCALE as specified in the 
SET SCALE subcommand (or SCALE prefix subcommand). 

SCOPE 

displays "DISPLAY" or "ALL" as specified by the SET SCOPE subcommand. 
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SCReen 

displays the attributes of the screens that have been defined by the SET 
SCREEN subcommand preceded by SIZE, WIDTH, or DEFINE. 

SELect 

displays the selection level of the current line and the maximum selection level 
for the file as specified by the SET SELECT subcommand. 

Seq8 

displays "OFF" if the XEDIT command or LOAD subcommand was issued 
with the NOSEQ8 operand; if not, displays "ON." 

SERial 

displays the serial identification, the increment value, and the serial number 
starting value as defined by the SET SERIAL subcommand. 

SHADOW 

displays "ON" or "OFF" as specified by the SET SHADOW subcommand. 

SIDcode 

displays the eight-character string specified in the SIDCODE option of the 
XEDIT command, the LOAD subcommand, or the SET SIDCODE 
subcommand. 

SIZe 

displays the number of records in the file being edited. 

SPAN 

displays "ON" or "OFF," "B" or "N," and n as defined in the SET SPAN 
subcommand. 

SPILL 

displays "ON," "OFF," or "WORD" as defined by the SET SPILL 
subcommand. 

STAY 

displays "ON" or "OFF" as specified in the SET STAY subcommand. 

STReam 

displays "ON" or "OFF" as specified in the SET STREAM subcommand. 

SYNonym [*\name] 

QUERY SYNONYM displays "ON" or "OFF" as specified in the SET 
SYNONYM subcommand. 

QUERY SYNONYM * displays for each defined synonym its name, its 
minimum abbreviation, and the associated synonym definition which includes 
the LINEND char, if specified, and everything that was specified in the SET 
SYNONYM subcommand after the size of the minimum abbreviation. 
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QUERY SYNONYM name displays the synonym, its minimum abbreviation, 
and the associated synonym definition which includes the LINEND char, if 
specified, and everything that was specified in the SET SYNONYM 
subcommand after the size of the minimum abbreviation. 

(If no synonym was defined, only the name is displayed.) For example: 

set synonym up 1 down 
query syn u 

displays the following: SYNONYM UP U DOWN 

TABLine 

displays "ON" or "OFF" and the position of the TABLINE as defined in the 
SET TABLINE subcommand (or TABL prefix subcommand). 

TABS 

displays the tab column numbers defined by the SET TABS subcommand. 

TARGet 

displays the following information about the character string that matches the 
last target located via a LOCATE or CLOCATE subcommand: line and column 
number of the first character in the string; line and column number of the last 
character in the string. If the last target located was specified with "&," then 
only information about the last string found is displayed. 

If the target of the LOCATE or CLOCATE has been specified as an absolute 
line number, a relative displacement from the current line, or a line name, then 
QUERY TARGET displays the Une number and current column position 
(twice). 

Information returned by QUERY TARGET may be incorrect unless the 
QUERY is done immediately following the LOCATE or CLOCATE of the 
target. Any XEDIT subcommand issued between the LOCATE or CLOCATE 
of the target and the QUERY has the potential to invahdate the TARGET 
information. 

TERMinal 

displays "DISPLAY" or "TYPEWRITER" as defined in the SET TERMINAL 
subcommand. 

TEXT 

displays "ON" or "OFF" as specified in the SET TEXT subcommand. 

TOF 

displays "ON" or "OFF" as determined by the editor. TOF is "ON" when the 
Une pointer reaches top of file (or top of range). 

TOFEOF 

displays "ON" or "OFF" as specified in the SET TOFEOF subcommand. 

TOL 

displays "ON" or "OFF" as determined by the editor. TOL is "ON" when the 
column pointer reaches zonel — 1. 
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TRANSLat 

displays "ON" or "OFF," depending on whether or not the user has defined 
pairs of uppercase translate characters using the SET TRANSLAT 
subcommand. 

TRunc 

displays the truncation column number as defined by the SET TRUNC 
subcommand. 

UNIQueid 

displays a unique identifier associated with the file. The identifier has the form 
rrrnnnnn where rrr is the number of times XEDIT was called recursively and 
nnnnn is the current autosave number. Note that when the recursion level, rrr^ is 
less than 100, the leading zero(es) will be dropped. The uniqueid is also used as 
the file name for the AUTOSAVE file. 

UNTil 

displays the file type up through which updates were applied as specified on the 
XEDIT command or LOAD subcommand. 

UPDate 

displays "ON" or "OFF" as determined by the editor. Update is "ON" when 
the XEDIT command or LOAD subcommand has been issued and the 
UPDATE option was specified or impHed. 

VARbiank 

displays "ON" or "OFF" as specified in the SET VARBLANK subcommand. 

Verify 

displays the verification columns and "ON" or "OFF" as specified in the SET 
VERIFY subcommand. 

VERShift 

displays n or - n, which is the relative position of the screen over the file, as a 
result of any LEFT or RIGHT subcommands. 

Width 

displays the WIDTH value specified in the XEDIT command or LOAD 
subcommand. 

WRap 

displays "ON" or "OFF" as specified in the SET WRAP subcommand. 

Zone 

displays the left and right zone column numbers specified in the SET ZONE 
subcommand. 
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displays the string in the equal ( = ) buffer. The = buffer contains the last 
executed subcommand or macro or CP/CMS command, or whatever has been 
specified in the SET = subcommand. 



Messages 



520E InvaUd operand: operand [RC = 5] 

525E Invalid {PFkey|PFkey/PAkey} number [RC 

538E No name defined [RC = 3] 

545E Missing operand(s) [RC = 5] 



5] 



Return Codes 



Normal 

3 'QUERY POINT *' was issued, but no symboUc names are defined. 

5 Invahd or missing operand(s) or number 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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Format 



Operand 



Use the QUIT subcommand to terminate the current editing session and leave the 
previous copy of the file, if any, intact on the disk or directory. If the file has been 
changed during the editing session, the editor displays a warning message asking you 
to confirm that you want to issue a QUIT (instead of a FILE) subcommand. When 
issued from a macro, the QUIT subcommand can be used to specify a return code. 




is a return code that may be specified when QUIT is issued from a macro. 



Usage Notes 

1 . You can use the QUIT subcommand when you edit a file merely to examine, but 
not to change, its contents, or whenever you discover you have made errors in 
editing a file and want to cancel your editing session. 

2. If only one file was edited, control is returned to the environment which invoked 
the editor. 

3. If more than one file was being edited, only the current file is terminated. 
Control remains in the edit environment. You can use the CANCEL macro to 
"quit" multiple files. 

4. The QUIT subcommand is initially assigned to the PF3 key. 

5. When editing two or more members of a MACLIB in member mode, the lock 
on the Ubrary is not deleted until the last member that had the lock option in 
effect exits the ring. 

Notes for Macro Writers 

1 . QUIT is defined as a synonym to PQUIT. The PQUIT (protected quit) 
subcommand causes a warning message to be displayed (see responses) if the file 
was changed during editing. To bypass the message and have the QUIT 
subcommand executed directly, you can define QUIT as a synonym to 
COMMAND QUIT, or you can issue QQUIT, which is an unprotected "quick 
quit." 

The PQUIT subcommand clears the console stack. If you do not want the 
console stack to be cleared, use COMMAND QUIT. 

2. If QUIT is issued from a macro, control remains in the macro until the macro 
finishes executing. Then, control is returned to the editor. 

If multiple files were being edited, only the current file is terminated. 

If QUIT executes successfully from a macro, the return code is set to n if 
specified. If n was not specified and only one file was being edited, a QUIT 
issued from a macro sets the return code to 1 and executes the QUIT when the 
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Responses 



macro completes execution. After issuing the QUIT, any subcommands issued 
in the macro will result in a return code of 6. 

3. QUIT or PQUIT may not be issued from a prefix macro. 

4. Negative numbers may not be specified for «. 



If only one file was edited, the CMS ready message indicates that control has been 
returned to CMS. If more than one file was being edited, the file that was being 
edited before the terminated file appears on the screen. 

If the file was changed during the editing session, the following message is displayed: 



Messages 



Return Codes 



577E File has been changed; use QQUIT to quit anyway 

If you wish to save the changes, issue a FILE subcommand. 
On a typewriter terminal, the following message is displayed: 

5531 Editing file: fn ft fm 



509E subcommand subcommand not valid from a prefix macro [RC = 4] 

520E Invalid operand: operand [RC = 5] 

543E InvaUd number: number [RC = 5] 

5531 Editing file: /« /if /m 

554E Not enough virtual storage available 

577E File has been changed; type QQUIT to quit anyway [RC= 12] 

622E Insufficient free storage for MSGLINE 

1300E Error nn unlocking file fn ft dirname 



Normal 

1 Only one file was edited 

4 Invalid when issued from a prefix macro 

5 Invahd operand or number 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 

12 File has been changed. Use QQUIT to QUIT anyway 

n The number specified as an operand to the subcommand 
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Use the READ subcommand to place information from the terminal in the console 
stack (LIFO). The READ subcommand is designed to be issued from a macro. 
After a READ subcommand is executed, a System Product Interpreter macro has 
access to the stacked information via the REXX PULL instruction. (In an EXEC 2 
macro, access can be gained via the &READ control statement). 



Format 



READ 




Cmdiine 

AH [Number] 

Nochange [Number] 




Tag 
Notag 





Operands 



Cmdiine 



indicates that only the command input area is to be stacked in the console stack. 
This is the default. 

All 

indicates that all Unes changed on the screen will be stacked in the console stack, 
and the command input area will be stacked as the last hne. The corresponding 
changes will also be made to the copy of the file that is in virtual storage. 

Nochange 

is similar to the ALL option (above) except that the changes made on the screen 
are not made to the file being edited but are available from the console stack. 

Number 

indicates that the lines changed on the screen are to be prefixed by their file hne 
numbers. 



Tag 



specifies that a tag identifying the origin of the Hne is inserted at the beginning 
of each hne stacked. (The tags are described in note 5, below.) 

Notag 

specifies that no tags are inserted in the stacked Hnes. 

Notes for Macro Writers 

1 . If the console stack already contains a line when a READ subcommand is 
issued, the READ is a no-op (no operation takes place). 

2. If a READ is issued from a typewriter terminal, only the command line is placed 
in the stack. 

3. A READ subcommand is terminated by pressing either the ENTER key, a PF 
key, or a PA key; however, a key assigned to COPYKEY, NULLKEY, 
TABKEY, or the CP BRKKEY does not terminate a READ. Pressing the 
CLEAR key clears any data that was typed since the last time the ENTER key, 
a PF key, or a PA key was pressed, but it also does not terminate a READ. 
The operand specified for the READ subcommand (Cmdiine, All, or Nochange) 
determines which lines are placed in the console stack. The same number of 
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lines are stacked whether TAG or NOT AG is specified. The TAG operand 
causes each hne in the stack to be preceded by a tag. The various tags are 
described in note 4, below. 

Using READ CMDLINE 

The key pressed to terminate the READ command (a PF key, a PA key, or the 
ENTER key) and how that key is defined (BEFORE, AFTER, ONLY, or 
IGNORE), determine which lines are placed in the console stack. 

If something was entered on the command hne, the console stack will contain 
the following line(s), as determined by the definition of the key that was pressed: 

If the key was defined as 'BEFORE', the console stack will contain: 

a. ENTER, PF, or PA key value (depending on which key was pressed) 

b. Command line. 

If the key was defined as 'AFTER', the console stack will contain: 

a. Command line 

b. ENTER, PF, or PA key value (depending on which key was pressed). 

If the key was defined as 'IGNORE', the console stack will contain: 

a. Command Une. 
If the key was defined as 'ONLY', the console stack will contain: 

a. ENTER, PF, or PA key value (depending on which key was pressed). 

If nothing was entered on the command line (or ERASE EOF was used to clear 
the command line), the console stack will contain the definition of the key 
(ENTER, PF, or PA key) that was pressed. 

Using READ ALL or READ NOCHANGE 

The editor scans the screen (from top to bottom, left to right) and stacks all 
modified fields. Each modified field is stacked as a separate line. If either the 
ALL or NOCHANGE operand is used, the console stack contains: 

a. ENTER, PF, or PA key value (depending on which key was pressed) 

b. Lines and prefix areas changed on the screen (if any) 

c. Command line (if something was entered on the command line). 

If nothing was changed on the screen, the console stack contains the ENTER, 
PF, or PA key value (depending on which key was pressed). 

4. With the TAG operand specified, each line in the stack is preceded by a tag, 
which identifies the field. The tags and their meanings are as follows: 



CMD 


— command hne 


ETK 


- ENTER key 


FIL 


— file Hne 


PAK 


- PA key 


PFK 


- PF key 


PRF 


— prefix area 


RES 


— reserved Une 



The tag is followed by additional information and the modified field itself: 
• CMD string 

where string is whatever was typed in the command line. 
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The string can be empty if a key which is not defined is pressed. In this 
case, only the tag (CMD) is stacked (or a null Hne if READ NOTAG is 
specified). 



• ETK string 

where string is the ENTER key definition. 

• FIL nl n2 [n3] string 

where: 

nl n2 

are the line number and column number of the beginning of the line 



n3 



on the screen. 

is the corresponding file line number. The file line number is returned 
only if the READ subcommand was issued with the NUMBER 
option. 

string 

is the changed file line. (String can be empty if the ERASE EOF key 
was pressed.) 

PAK n string 

where: 

n 

is the number of the PA key that was pressed to terminate the READ. 

string 

is the PA key definition. 

PAK lines are stacked LIFO. 

PFK n string 

where: 



is the number of the PF key that was pressed to terminate the READ. 

string 

is the PF key definition. 

PFK Unes are stacked LIFO. 

PRE nl n2 [n3] string 

where: 

nl n2 

are the line number and column number of the prefix area on the 
screen. 



nS 



is the corresponding file line number associated with the prefix area. 
The file line number is returned only if the READ subcommand was 
issued with the NUMBER option. 
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READ 



string 

is whatever was typed in the prefix area. (String can be empty if the 
ERASE EOF key was pressed). The string is whatever the user typed 
in the prefix area, as determined by XEDIT. For example, with SET 
NUMBER OFF, typing "a" in the prefix area returns "a" and not 
"a= = = =". 

• RES nl n2 string 

where: 

nl n2 

are the line number and column number of the reserved field on the 
screen. 

string 

is the reserved field that was changed. (String can be empty if the 
ERASE EOF key was pressed.) 

5. If a command is entered on a screen that is in "MORE" status, the command is 
placed in the CMS input queue. 



The message, "Macro-read n File(s)", is displayed in the status area. 



509E subcommand subcommand not valid from a prefix macro [RC = 4] 
520E Invalid operand: operand [RC = 5] 



Normal 

1 TOF or EOF reached 

4 InvaUd when issued from a prefix macro 

5 Invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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Format 



Operand 



Use the RECOVER subcommand to replace a specified number of lines that were 
removed by a DELETE, a MERGE, or a PUTD subcommand, or a D (delete) 
prefix subcommand. 




is the number of lines removed by a DELETE, a MERGE, or a PUTD 
subcommand or a D prefix subcommand that you wish to replace in the file. If 
you specify an asterisk (*), all deleted lines are replaced. If you omit n, only the 
last line that was removed is reinserted in the file. 



Usage Notes 



1 . The last lines that were deleted are the first to be recovered. For instance, a 
DELETE 10 followed by a RECOVER 5 would recover the last five lines of the 
10 deleted fines. 

2. Once a deleted line is recovered, it is removed from the buffer that contains 
recoverable lines. Therefore, DELETE followed by multiple RECOVER 
subcommands cannot be used to duplicate a line at various locations in a file. 

3. When multiple files are being edited, there is only one buffer for all removed 
lines. Thus, a line could be deleted in one file and recovered in another file if 
the width of the two files is the same. 



4. RECOVER subcommands do not have to match DELETE subconmiands. 
following is a vaUd sequence: 

delete 2 



The 



delete 3 



recover 1 



recover 4 

The size of the recoverable lines buffer depends on the amount of virtual 
storage. 

Macros, such as JOIN, that use the DELETE, MERGE or PUTD 
subcommands will put Unes in the buffer that contains recoverable lines. 

If you are editing a file in update mode (where the status area indicates 
Update-mode n File(s)), deleted lines that are reflected in an update file cannot 
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be recovered. Please refer to the XEDIT command in this publication for more 
information on update mode. 



Response 



The recovered line(s) is inserted at the current line. The following message is 
displayed: 

5021 nn line(s) recovered 

The recovered line becomes the new current line. 

Messages 

520E Invalid operand: operand [RC = 5] 

543 E Invalid number: number [RC = 5] 

5021 {No|««} line(s) recovered [RC = or 3] 

Return Codes 

'n' lines have been inserted 
3 Pool of deleted lines is empty 

5 Invalid operand or number 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 



Chapter 3. XEDIT Subcommands and Macros 181 



REFRESH 



REFRESH 



Format 



Use the REFRESH subcommand to display the screen. Issued from a macro, it 
presents the screen as of that moment in processing, without waiting for input. 




Note to Macro Writers 

REFRESH can be used to update the display on the screen without exiting the 
macro. 



Messages 



Return Codes 



117S 

520E 
529E 



Error writing to display terminal [RC = 8] 

Invalid operand: operand [RC = 5] 

Subcommand is only vahd in {display|editing} mode [RC = 3] 

Normal 

Subcommand vahd only for display terminal 

Invahd operand 

Subcommand rejected in the profile due to LOAD error, or QUIT 

subcommand has been issued in a macro called from the last file in the ring 

I/O error writing to screen 
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Format 



RENUM 



Use the RENUM subcommand to renumber the hne numbers of VSBASIC or 
FREEFORT files. 



RENum 




startno 
10 


incr 







Operands 



startno 

specifies the first line number of the file. If you omit startno, the file starts with 
line number 10. 



incr 



specifies the value by which each hne number is incremented. If you omit incr, 
the value specified as startno is assumed. 



Usage Notes 



Responses 



1. The startno and incr values cannot exceed 99999 for VSBASIC files or 99999999 
for FREEFORT files. 

2. This subcommand is intended to be used in EDIT migration mode; XEDIT does 
not perform line number editing. 

3. This subcommand should not be used for a VSBASIC file that has a logical 
record length greater than 256. 



If you are not in a VSBASIC or FREEPORT file and you enter the RENUM 
command, the following message is displayed: 



Wrong file fomat for RENUM 

When RENUM finds an invahd VSBASIC or FREEFORT statement in your file, 
one of the following messages is displayed: 



Maximum line number exceeded 

Overflow at statement number 

Invalid syntax in statement number 

Invalid line number reference in statement number 

Line number referenced in statement number not found 
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Messages 



002E 
037E 
069E 
104S 
105S 

520E 
531E 

535E 
543E 
554E 



File fn ft fm not found [RC = 28] 

Filemode mode is accessed as read/only [RC = 12] 

Filemode mode not accessed [RC = 36] 

Error nn reading Rle/nftfrn from disk [RC = 31, 55, 70, 99, or 100] 

Error nn writing file fn ft fm on disk [RC = 31, 55, 70, 99, or 100] 



Invalid operand: operand [RC = 5] 

Disk is full; set new filemode or clear some disk space [RC ■■ 

Invalid parameters for RENUM [RC = 5] 

Invalid number: number [RC = 5] 

Not enough virtual storage available [RC = 104] 



13] 



Return Codes 



Normal 

5 Invalid operand or number 

6 Subconmiand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 

12 File mode is accessed as read/only 

13 Minidisk or file space is full 

28 File not found 

31 A rollback occurred 

32 Format or content of input file invalid 
36 Mode not accessed 

55 APPC/VM communications error 

70 File sharing conflict 

99 A required system resource is not available 

100 Error reading/writing file to disk 

104 Out of virtual storage 
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Format 



Operand 



Usage Notes 



Use the REPEAT subcommand to advance the Une pointer and to execute the last 
subcommand that was entered. The REPEAT subcommand is equivalent to 
executing the two subcommands, NEXT 1 (or UP 1) and =, for a specified number 
of times. 




target 

specifies the number of times that the REPEAT subcommand executes, starting 
on the line following the current line. REPEAT computes the number of Unes 
between the current Une and the Une preceding the target line. The last 
subcommand entered is then REPEATed for this number of times. If you 
specify an asterisk (*), the previous subcommand is repeated up to the end of 
file. If you omit target, the previous subcommand is executed on the Une 
following the current one. 

A target may be specified as an absolute Une number, a relative displacement 
from the current line, a line name, or a string expression. For more information 
on targets, refer to the LOCATE subcommand in this book and to the 
publication VM/SP System Product Editor User's Guide. 



1. If the target is in a forward direction, REPEAT is equivalent to: 

next 1 

2. If the target is in a backward direction, that is, specified with a leading minus 
(— ) sign, REPEAT is equivalent to: 



up 1 



3. If the previous subcommand contains a target or is a subcommand whose 
purpose is to move the Une pointer (such as NEXT), the execution of the 
REPEAT subcommand may occur beyond the Une specified by the target of the 
REPEAT. 

4. If the previous subcommand results in a non-zero return code, the execution of 
the REPEAT subcommand will terminate on that Une. 



Response 



The response, if any, from the repeated subcommand is displayed. 
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Messages 

520E Invalid operand: operand [RC = 5] 
546E Target not found [RC =2] 



Return Codes 



1 TOP or EOF reached 

2 Target not found 

5 Invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 

nn Same as the repeated subcommand's return codes 
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Format 



Operand 



Usage Notes 



Use the REPLACE subcommand to replace the current Hne with a specified Hne or 
to delete the current line and enter input mode. 




text 



specifies an input hne that is to replace the current Une. If a Hne is specified, the 
editor puts it into the file in place of the current Hne. If no Hne is specified, the 
editor deletes the current Hne and enters input mode. 



1 . If a REPLACE subcommand is issued when the current Hne is the Top of File 
Hne, the text is inserted after the Top of File line. If it is issued when the 
current line is the End of File line, the text is inserted before the End of File 
line. 

2. If SET SPILL OFF is in effect (the default), characters that have been pushed 
beyond the truncation column are truncated. If SET SPILL ON or SET SPILL 
WORD has been issued, characters that have been pushed beyond the truncation 
column are inserted in the file as one or more new Hnes starting with the first 
character or word that would have gone beyond the truncation column. 

3. If REPLACE is issued without operands, the current line is deleted and input 
mode is entered. If you do not enter any data, the deleted Hne is recovered. 
However, if the editor is in update mode the deleted Hne is not recovered. 

4. If SET IMAGE ON is in effect, tabs are converted to blanks before a Hne is 
inserted into the file. 



Responses 



When you issue a REPLACE subcommand with no operand, the following message 
is displayed: 



Messages 



5731 input mode: 



503E {TruncatedlSpilled} [RC = 3] 

557S No more storage to insert Hnes [RC = 4] 
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Return Codes 



Examples 



Normal 

3 Truncated or spilled 

4 Not enough storage to add lines 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 

subcommand has been issued in a macro called from the last file in the ring 



Current Line 

===== This is the current line. 

replace Now this is the new current line. 
===== Now this is the new current line. 
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Format 



RESET 



Use the RESET subcommand to remove all prefix subcommands or macros when 
the screen is in a "pending" status. 




Usage Notes 

1. The RESET subcommand removes all prefix subcommands and/or macros when 
the screen displays a pending status. 

2. To remove prefix subcommands or macros when the screen is not in a pending 
status, press the CLEAR key. 

3. RESET does not reset the prefix area of shadow lines or any Unes outside the 
defined scope. See SET SCOPE. 

Note for Prefix Macro Writers 

If a user enters RESET when a prefix macro is pending, that macro is invoked with 
the argument string "PREFIX CLEAR pUne" where "pUne" is the Une number for 
the line on which the prefix macro was pending. When the macro examines the 
argument string and finds it was invoked with the CLEAR argument, it would 
(usually) stop processing. (For a complete description of the argument string that is 
automatically passed to a prefix macro, see the VM/SP System Product Editor User's 
Guide.) 



Response 

i\/lessage 
Return Codes 



Example 



The original prefix area (equal signs or line numbers) replaces any prefix 
subcommands or macros that were typed in. 



520E Invalid operand: operand [RC == 5] 



Normal 

5 InvaUd operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 



If a block of lines to be moved or copied is initiated by typing MM or CC in the 
first and last hues of the block, but the destination Une has not yet been entered (via 
P or F), the operation can be canceled by RESET. 
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Format 



Usage Notes 



Messages 



Return Codes 



Use the RESTORE subcommand to restore the settings of the XEDIT variables to 
the values they had when the PRESERVE subcommand was last issued. 




1 . Refer to the PRESERVE subcommand for a list of the variables affected by the 
RESTORE subcommand. 

2. If the column pointer was located outside the restored zone settings, it is 
repositioned to the left or right zone. If the column pointer was positioned to 
the left of the new zone, it moves to Top of Line (TOL). If it was positioned 
beyond the new right zone, it moves to End of Line (EOL). 



507E No preserved data to restore [RC = 3] 
520E Invahd operand: operand [RC = 5] 



Normal 

1 The column pointer was located outside the restored zone settings 
3 No PRESERVE has been issued 

5 InvaUd operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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RGTLEFT (Macro) 



Format 



Operand 



Usage Notes 



Messages 



Use the RGTLEFT macro to view columns of data that are not currently visible on 
the screen. 




is the number of columns that you want the screen to be moved. Whether the 
screen moves to the right or the left depends on the current VERSHIFT value 
(see usage note 3). If n is not specified, the screen is moved up to a maximum 
of three-fourths of the logical screen width (for example, 60 characters on an 
80-character screen). If the logical record length is less than this value (screen 
width plus 3/4 screen width), the screen moves only enough to display the rest of 
the logical record, up to a maximum of three-fourths of the first verify width 
(the number of columns in the first verify pair). For example, if VERIFY is set 
at 1 40 on a file with a record length of 80, the first RGTLEFT command 
moves the screen right 30 columns (3/4 of 40) and columns 31 through 70 are 
displayed. 



1 . The RGTLEFT macro does not cause data to be lost, nor does it move the Une 
or column pointer. 

2. The RGTLEFT macro is most useful when assigned to a PF key. The PFIO key 
is initially set to RGTLEFT. Pressing the PF key enables you to see data to the 
right of the screen; pressing the PF key again returns the screen to the original 
view of the file. 

3. The current VERSHIFT setting (see QUERY VERSHIFT) determines whether 
the view is moved right or left when RGTLEFT is issued. If VERSHIFT is less 
than or equal to zero, the view is moved to the right, making the VERSHIFT 
value greater than zero. When VERSHIFT is greater than zero, the view is 
moved back to the left, returning to the original display of the file. 



520E Invahd operand: operand [RC = 5] 

529E RGTLEFT is only vahd in { display | editing} mode [RC = 3] 
543 E Invahd number: number [RC == 5] 

576E {Total verify width exceeds screen size (««)iTotal offset exceeds LRECL 
(««)} [RC = 5] 
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Return Codes 

Normal 

3 RGTLEFT valid in display mode only 

5 Invalid operand or number 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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Format 



Operand 



RIGHT 



Use the RIGHT subcommand to view columns of data that are not currently visible 
on the screen. The RIGHT subcommand allows you to see data that is to the right 
of the last (right-most) column on the screen. The data moves to the left, thus 
allowing you to see a specified nimiber of positions to the right of the last column. 




specifies the number of positions to the right of the last column on the screen 
that you want to see. If you omit n, one position to the right of the last column 
becomes visible. 



Usage Notes 

1. The RIGHT subcommand does not cause data to be lost, nor does it move the 
line or column pointer. 

2. To get the data back to its original position, use the LEFT n subcommand. See 
also the RGTLEFT macro. 

3. RIGHT subcommands are cumulative. For example: 

ri IG 
ri 10 

is equivalent to 

ri 2G 

4. If you have issued several RIGHT and/or LEFT subcommands and have 
forgotten the total value of n: 

a. RIGHT or LEFT restores the screen to its original display. 

b. SET VERIFY resets RIGHT (or LEFT) to zero. 

c. QUERY VERSHIFT displays n (the result of a RIGHT) or -n (the result 
of a LEFT). 

5. The total number of columns moved cannot exceed the logical record length. 

Notes for Macro Writers 

EXTRACT/VERSHIFT/ returns the value of n or -n. 



Response 



The screen moves to the right relative to the file data. 



Chapter 3. XEDIT Subcommands and Macros 193 



RIGHT 



Messages 



520E Invalid operand: operand [RC = 5] 
543 E Invalid number: number [RC = 5] 

576E {Total verify width exceeds screen size (««)|Total offset exceeds LRECL 
(««)} [RC = 5] 



Return Codes 



Normal 

5 Invalid operand or number 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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Examples 



Figure 12 is a before-and-after example of the RIGHT subcommand. 



OGDEN NASH Ai v 80 Trunc=80 Size=28 Line=20 Co1=l Alt=0 







== THE SONG OF CANARIES 
== NEVER VARIES. 
== AND WHEN THEY'RE MOULTING 
== THEY'RE PRETTY REVOLTING. 

== THE GIRAFFE 

== I BEG YOU, CHILDREN. DO NOT LAUGH 
== WHEN YOU SURVEY THE TALL GIRAFFE. 

I... +....!.... +....2.... +...,3.... +....4.... +....5.... +....6.... +...,7. 
== IT'S HARDLY SPORTING TO ATTACK 
== A BEAST THAT CANNOT ANSWER BACK. 
== HE HAS A TRUMPET FOR A THROAT. 
== AND CANNOT BLOW A SINGLE NOTE. 
== IT ISN'T THAT HIS VOICE HE HOARDS; 
== HE HASN'T ANY VOCAL CORDS. 
== I WISH FOR HIM, AND FOR HIS WIFE. 
== A VOLUBLE GIRAFTER LIFE. 
== * * * End of File * * * 



right 10 



X E D I T 1 File 



OGDEN NASH Al V 80 Trunc=80 Size=28 Line=20 Col=l Alt=0 



F CANARIES 

ES. 

HEY 'RE MOULTING 

ETTY REVOLTING. 

E 

CHILDREN, DO NOT LAUGH 
URVEY THE TALL GIRAFFE. 

-i- 2 + 3 + 4 + 5 + 6 + 7, 

Y SPORTING TO ATTACK 
AT CANNOT ANSWER BACK. 
RUMPET FOR A THROAT, 

BLOW A SINGLE NOTE. 
HAT HIS VOICE HE HOARDS; 
ANY VOCAL CORDS. 

HIM, AND FOR HIS WIFE, 



GIRAFTER LIFE. 

* * * End of File * * * 



X E D I T 1 File 



Figure 12. The RIGHT Subcommand — Before and After 
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SAVE 



Use the SAVE subcommand to write the edited file on disk or in an SFS directory 
without returning control to the environment that invoked the editor. You may also 
use the SAVE subcommand to change the file identifier. 



Format 



SAVE 




fn 


'ft 


'fm\ 


1 



Operands 



fn 



ft 



fm 



indicates the file name of the file to be saved (or membemame when editing a 
member of a MACLIB). If you specify only fn, the file type and file mode 
remain the same. 

indicates the file type of the file to be saved. 

indicates the file mode of the file to be saved. 



Usage Notes 



1. If the file mode indicates an accessed minidisk, the minidisk must be accessed 
read/write. If the file mode indicates an accessed SFS directory, it can be 
accessed as either read/only or read/write. 

2. You must have write authority to an existing file to save it in another user's SFS 
directory. 

3. If you have write authority to another user's SFS directory, you can create a 
new file in that directory even though you have the directory accessed read/only. 
The owner of the directory is now the owner of the new file, but because you 
created the file, you have write authority for the file. 

4. If you specify a new file identifier, the original copy of the file on disk or 
directory is not changed. Changing the file identifier simply creates another 
copy of the file with a new file identifier. 

5. If you try to SAVE a shared file that has been modified by another user during 
your editing session, the editor stops the SAVE operation and displays the 
following message: 

594E File fn ft fm already exists or changed; use FFILE or SSAVE 

At this point you can decide whether to preserve the other user's changes or 
write over them. If you want to write over the other user's changes, causing 
them to be lost, enter SSAVE (abbreviated as SS). If not, change the file 
identifier so it is unique and reissue the SAVE subcommand to save your 
changes under a different name. Later, you can determine what the differences 
are between the two versions of the file and combine them. 
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To avoid this situation, use the LOCK option on the XEDIT command to 
prevent other users from changing the file while you are editing it. The LOCK 
option is the default. 

Message 594E is also displayed if you change the file identifier so that it is 
identical to that of an existing file and try to save it. 

This "protected SAVE" works in the following way. SAVE is defined as a 
synonym to PSAVE, which is the protected equivalent of SAVE. SSAVE is a 
synonym for COMMAND SAVE. 

6. To write a file to disk or directory and end the editing session, use the FILE 
subcommand instead of the SAVE subcommand. 

7. If you want a file to be saved automatically at regular intervals, use the SET 
AUTOS AVE subcommand. 

8. The operand fn, ft, or fm may be specified as an equal ( = ) sign, in which case 
the corresponding value of the file currently being edited is used. 

9. If the automatic save function is in effect (SET AUTOSAVE subcommand), the 
corresponding AUTOSAVE file is erased when a SAVE is executed. 

10. Changing a membername 

If you change the membername (to a unique membername) and the member has 
previously been written to disk or directory, that copy with the original name of 
the member is not altered. 

However, if you change the membername while editing a member so that the 
new membername is identical to that of an existing member, the editor stops the 
SAVE operation and displays the following warning: 

594E File fn ft fm already exists or changed; use FFILE or SSAVE 

If you want to write over the existing member, enter SSAVE (abbreviated as SS). 
If not, change the membername so that it is unique and reissue the SAVE 
subcommand. 

11. Members of a MACLIB must have a file type of MEMBER. 

12. Members with identical names contained in Hbraries with identical names, but 
residing on different disks or directories, will not be written over if you attempt 
to change the file mode. The following warning will be issued. 

594E File fn ft fm already exists or changed; use FFILE or SSAVF 

For example: 

PROJA MACLIB Al PROJA MACLIB Bl 

ENTER ENTER 

LEAVE LEAVE 

FORMAT FORMAT 

COMPUTE COMPUTE 

If you are edifing the ENTER member in the PROJA MACLIB that resides on 
your file mode B and attempt to change the file mode by issuing "SAVE ^ = 
A," the warning message is issued. 
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Messages 



002E File fn ft fm not found [RC = 28] 

007E File fn ftfm is not fixed, 80-character records [RC = 32] 

033E File fn ft fm is not a library [RC = 32] 

037E Filemode mode is accessed as read/only [RC= 12] 

039E No entries in library fn ft fm [RC = 32] 

048E Invalid mode mode [RC = 24] 

062E Invalid character in fileid fn ft fm [RC = 20] 

069E Filemode mode not accessed [RC = 36] 

104S Error nn reading file fn ft fm from disk [RC = 3 1 , 55, 99, or 100] 

105S Error nn writing me fn ftfm on disk [RC = 55, 70, 76, 99, or 100] 

1 57S MACLIB limit exceeded [RC = 88] 

167S Previous MACLIB function not finished [RC = 88] 

229E Unsupported OS dataset, error nn [RC = 80, 8 1 , 82, 83, or 84] 

520E Invahd operand: operand [RC = 5] 

53 IE Disk or file space is full; set new filemode or clear some space [RC= 13] 

532E Disk or file space is full; AUTOSAVE failed 

554E Not enough virtual storage available [RC= 104] 

559W Warning: empty file not written to disk 

560E Not enough space for serialization between TRUNC and LRECL 

579E Records truncated to nn when added to fn ft fm [RC = 3] 

594E File fn ft fm already exists or changed; use FFILE or SSAVE [RC = 3] 

598 S Unable to build update file: internal Ust destroyed [RC = 7] 

599S Unable to build update file: serialization destroyed [RC = 7] 

622E Insufficient free storage for reading map [RC = 104] 

1 1 38E File sharing conflict for file fn ft fm [RC = 70] 

1141W User filespace threshold exceeded 

1 2 1 5E File fn ft fm is locked by another user [RC = 70] 

1 258E Not authorized to write file fn ft fm [RC = 1 2] 

1262S Error nn opening me fn ftfm [RC = 55, 70, 76, 99, or 100] 

1 30 1 S Rollback error nn, file fn ft fm left open 



Return Codes 



Normal 

3 Truncated or spilled, or file already exists 

5 Invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 

7 Error building the update file 

12 Minidisk defined in file mode is read-only; or not authorized to write to file 

13 Minidisk or file space is full 

20 Invalid character in file name or file type 

24 Invalid file mode 

28 File not found 

31 A rollback occurred 

32 File is not a Ubrary, or hbrary has no entries, or file is not fixed, 80 char, 
records 

36 Corresponding minidisk or directory not accessed 

55 APPC/VM communications error 

70 File sharing conflict 

76 Connection error 
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80 An I/O error occurred while an OS data set or DOS file was being read or an 
OS or DOS disk was detached without being released. 

81 The file is an OS read-password-protected data set or a DOS file with the input 
security indicator on. 

82 The OS data set or DOS file is not BPAM, BSAM, or QSAM. 

83 The OS data set or DOS file has more than 16 user labels or data extents. 

84 Unsupported OS data set 

88 Previous Maclib function not finished, or Maclib limit exceeded 

99 A required system resource is not available 

100 Error readingi writing file fi:om|to disk 
104 Insufficient virtual storage 
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SCHANGE (Macro) 



Use the SCHANGE (selective change) macro to locate every occurrence of a string 
and to change that string only when you choose. 

The SCHANGE macro can be used when it has been assigned to a PF key (via the 
SET PF« subcommand). You can also type a CLOCATE or CHANGE 
subcommand on the command Hne before pressing the PF key assigned to the macro 
SCHANGE. By default, the SCHANGE macro automatically repeats the 
CLOCATE or CHANGE subcommand saved in the the LASTLORC buffer (see 
SET LASTLORC subcommand in this book.) 

If used with CLOCATE, only one PF key is needed. If used with CHANGE, two 
PF keys are required: one to locate the string; the other to perform the change. 

Each time the PF key assigned to SCHANGE (via the SET PFn subcommand) is 
pressed, the cursor is placed under the next occurrence of the string specified in the 
CHANGE or CLOCATE subcommand. The search for the string starts with the 
current column in the current line and continues throughout the file. 

If a CHANGE /string l/string2/ subcommand has been typed in the command line, 
pressing the second PF key will change stringl to string2. (This second PF key has 
no effect when the CLOCATE subcommand is used.) 

For an example of how to use the SCHANGE macro when it has been assigned to a 
PF key, see the VM/SP System Product Editor User's Guide. 



Format 



SCHANGE 



[keynumber J 



Operand 



Usage Notes 



keynumber 

is the PF key number that causes the CHANGE to be executed, after the string 
has been located by pressing the PF key assigned to SCHANGE. SET PF5 
SCHANGE 6 is the default assigned by the editor, but any numbers can be 
used. 



1 . Pressing the PF key assigned to SCHANGE causes the cursor to move but does 
not cause the line pointer to move (unless the screen is scrolled forward). The 
column pointer moves to the column where the specified string begins. 

2. The screen scrolls forward automatically after all occurrences of the string have 
been located on the current screen. 

The screen does not scroll forward if the string does not appear in the rest of the 
file. 

3. Pressing the PF key assigned to SCHANGE places the cursor under the first 
character of the string. 

Pressing the second PF key causes stringl to be replaced by string2. 
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4. The advantage of using SCHANGE with CLOCATE (rather than CLOCATE 
and = ) is that the cursor is placed under the matching string. 

5. SCHANGE will not change a string located to the left or right of the screen. 

6. SCHANGE can be assigned to a PA key instead of a PF key, however, the key 
number specified on the SCHANGE subcommand must be that of a PF key. 

7. When AUTOSAVE is set ON, the file is not autosaved until SCHANGE 
completes execution. Entering a subconimand other than the two PF keys 
assigned to SCHANGE and CHANGE completes execution of the SCHANGE 
macro. 



Responses 



Each time a string is located, the cursor is placed under the first character of the 
string, and the line containing the string is highlighted. 

If a CLOCATE subcommand is typed in the command line or saved in the 
LASTLORC buffer and the first PF key is pressed, the following message is 
displayed when a string is located: 

Target stringl found 

If a CHANGE subcommand is typed in the command line or saved in the 
LASTLORC buffer and the first PF key is pressed, the following message is 
displayed when a string is located: 

String stringl found; --- PFnn set for selective CHANGE 

When the second PF key is pressed, the following message is displayed: 

String stringl changed to stringZ 

If you press the PF key assigned to SCHANGE without first typing a CHANGE or 
CLOCATE in the command Une, and the LASTLORC buffer does not contain a 
CHANGE or CLOCATE subcommand, the following message is displayed: 

No CHANGE or CLOCATE subcommand specified 



Messages 



520E Invalid operand: operand [RC = 5] 

525E Invalid {PFkey|PFkey/PAkey} number [RC = 5] 

529E Subcommand is only valid in {displaylediting} mode [RC = 3] 

545E Missing operand(s) [RC = 5] 

56 IE Cursor is not on a valid data field [RC = 1 or 3] 

569E No CHANGE or CLOCATE subcommand specified [RC = 5] 

574E Change not valid {with CLOCATE after cursor movement} 

586E Not found [RC = 2] 
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Return Codes 

Normal 

2 Not found 

3 Invalid placement of cursor, or subcommand is valid only for display terminal 

5 Invalid or missing operands 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro caller from the last file in the ring 
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SET 



SET 



Use the SET subcommand to change the settings of various editing options while 
editing is in progress. Only one option may be specified in each SET subcommand. 
SET cannot be issued without an option. Use the QUERY subcommand to display 
the initial settings of SET options or the values set by previously issued SET 
subcommands. 

The options available with SET are summarized in the following list. A complete 
description of each option follows. 



ALT 


IMPcmscp 


SCReen 


APL 


LASTLorc 


SELect 


ARBchar 


LINENd 


SERial 


AUtosave 


LRecl 


SHADOW 


BRKkey 


MACRO 


SIDcode 


CASE 


MASK 


SPAN 


CMDline 


MSGLine 


SPILL 


COLOR 


MSGMode 


STAY 


COLPtr 


NONDisp 


STReam 


CTLchar 


NULls 


SYNonym 


CURLine 


NUMber 


TABLine 


Display 


PAn 


TABS 


ENTer 


PACK 


TERMinal 


ESCape 


PENDing 


TEXT 


ETARBCH 


PFn 


TOFEOF 


ETMODE 


Point 


TRANSLat 


FILler 


PREfix 


TRunc 


FMode 


RANge 


VARblank 


FName 


RECFm 


Verify 


FType 


REMOte 


WRap 


FULLread 


RESERved 


Zone 


HEX 


SCALe 


= 


IMage 


SCOPE 





Notes: 

1 . The subcommand name SET is generally optional. 

2. The editor assigns initial settings for each SET subcommand option. When you 
issue a SET subcommand, only those operands that you override are changed. 
All other operands retain their initial setting or default value. 
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SET ALT 



Format 



Operands 



Initial Setting 
Usage Notes 



Messages 



Use the ALT option to change the number of alterations that have been made to the 
file since the last AUTOSAVE and/or since the last SAVE. This count is displayed 
in the file identification line as Alt = n. 




represents the alteration count since the last AUTOSAVE. 

represents the total alteration count since the last SAVE. If you omit p, the 
total alteration count since SAVE remains unchanged. 



Both counts are initially set to zero. 



1. Both counts may be reset. If only one operand is specified (SET ALT n), the 
first count is reset. If two operands are specified, then both counts are reset. 

2. The subcommand "SET" is required with this option (to avoid conflict with the 
ALTER subcommand). 

3. The alteration count represents the number of subcommands that were executed 
which changed the file and the nimiber of lines modified when typing on the full 
screen. The alteration count will be incremented whenever any action is taken 
to modify a hne, even if the line has not actually been changed from its original 
state. For example, this will occur when a character in a line is overtyped or if 
the ERASE EOF key is pressed when the cursor is in column one. 

Macros that issue numerous commands that change the file may increase the 
count by more than one. 

4. SET ALT is intended to be used from within a macro. It should not be used for 
interactive editing because it can interfere with the AUTOSAVE function. 



520E InvaUd operand: operand [RC = 5] 
543E Invalid number: number [RC = 5] 
545E Missing operand(s) [RC = 5] 
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SET ALT 



Return Codes 

Normal 

5 Invalid or missing operand(s) or number 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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SET APL 



Format 



Operands 



Initial Setting 
Usage Notes 



Messages 



Return Codes 



Use the APL option to inform the editor and CMS if APL keys are available on the 
terminal. 




ON 



specifies that APL keys are available. You must issue a SET APL ON before 
using these keys so that proper character code conversion takes place. 



OFF 



specifies that no code conversion is to be performed for APL keys. 



Defined by the CMS SET APL setting. 



1 . If a terminal is equipped with the APL feature, special APL keys are available. 
Before using these keys, you must inform the editor so that proper character 
code conversion takes place. There are two ways to inform the editor: 

a. Issue CMS SET APL ON. 

b. Issue the editor SET APL ON subcommand. 

2. Because the conversion is costly, it is recommended that you issue the XEDIT 
subcommand SET APL OFF when you stop using the special keys. 

3. Issuing SET APL ON while TEXT is ON causes TEXT to be set to OFF. 
Similarly, issuing SET TEXT ON while APL is ON causes APL to be set to 
OFF. 

4. Changing the APL setting for XEDIT also changes the APL setting for CMS. 



520E InvaUd operand: operand [RC = 5] 
545E Missing operand(s) [RC = 5] 



Normal 

5 Missing or invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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SET ARBCHAR 



Format 



Operands 



Use the ARBCHAR option to define an arbitrary character to be used in a target 
definition. An arbitrary character used between character strings in a target 
definition means, "all intervening characters are to be ignored." 




ON 



turns on the use of a special character as an arbitrary character. 



char 



is the special character. The initial setting is a dollar sign ($). Several 
consecutive occurrences of the arbitrary character are equivalent to one. 



OFF 



turns off the use of a special character as an arbitrary character without 
changing the current character definition. 



Initial Setting 
Examples 



ARBCHAR OFF $ 

1. locate /air$plane/ 
will locate in the file 

"the airplane was landing" 
and will also locate in the file 
"cold air surrounded the plane" 

2. clocate /{$)/ 

will locate the first expression in the Une that is in parentheses. 

3. Any special character can be SET as an arbitrary character. If the arbitrary 
character is used consecutively a number of times in a target definition, it is 
treated as one, thus allowing, for example, the use of ellipsis. 

For example: 

set arbchar on . 
locate /air. . .plane/ 

is equivalent to 
locate /air. plane/ 
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Both will locate 

"airplane" or "cold air surrounded the plane" 

in the file. 

4. Using CHANGE with SET ARBCHAR: 

String2 must not contain more arbitrary characters than string 1. If it does, the 
following error message is displayed: 

StringZ contains more arbitrary characters than stringl. 
For example: 

Subcommand: set arbchar on $ 

File Line: the white house with several large windows 

Subcommand: c /the$house$windows/a$farmhouse$two$shutters/ 
Result: 

511E String2 contains more arbitrary characters than stringl 



Subcommand: c /the$house$windows/a$farmhouse$shutters/ 
Result: a white farmhouse with several large shutters 

String2 can have fewer arbitrary characters than stringl. For example: 

File Line: the white house with several large windows 

Subcommand: c/the$house$windows/a$large farmhouse/ 
Result: a white large farmhouse 
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Messages 



Return Codes 



SET ARBCHAR 



Special use of an arbitrary character: 

If a dollar sign ($) is the arbitrary character, it may be used in stringl and/or string2 
in the following ways: 

stringl: /$A/ 

The $ means, "the string starting in the zonel column and ending with the character 
that precedes A." (If no zone is defined, the string starts in column 1.) 

Example: 

change /$A/A/ 

deletes all characters that precede A within the same zone. 



stringl: /B$/ 

The $ means, "the string starting with the character following B and ending at the 
truncation column." If SET ZONE has been issued, the string ends at the zone2 
column rather than the truncation column. 

Example: 

change /B$/B/ 

deletes the characters that follow B. 



51 IE Stringl contains more arbitrary characters than stringl [RC = 5] 
520E Invalid operand: operand [RC = 5] 
545E Missing operand(s) [RC = 5] 



Normal 

5 Missing or invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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SET AUTOSAVE 



Format 



Use the AUTOSAVE option to set or reset the automatic save function of the 
editor. When the automatic save function is in effect, the editor automatically issues 
a SAVE subcommand each time the specified number of alterations is made. 



[set] 


AUtosave n 

OFF 


mode 
A 





Operands 



is a number that specifies the frequency of the automatic save function. One 
SAVE subcommand is issued for every n subcommands that change, delete, or 
add lines to the file. In a full screen environment, each line changed (by 
over-typing) counts as one. The automatic SAVE occurs when this number 
equals or exceeds n. 



OFF 



turns off the automatic save function. 



mode 



specifies the accessed minidisk or SFS directory on which the file is written, 
default mode is A. 



The 



Initial Setting: 
Usage Notes 



AUTOSAVE OFF 



1. You can use the QUERY AUTOSAVE subcommand to display the current 
AUTOSAVE setting. The file identification line indicates the number of changes 
since the last AUTOSAVE (Alt = n). 

2. When AUTOSAVE is in effect, SAVE or FILE subcommands will erase the 
corresponding AUTOSAVE file. The QUIT subcommand will not erase it. 

3. If the system crashes during an editing session, you can recover all changes made 
up to the time of the last automatic save. To do this, replace the original file 
with the AUTOSAVE file using the CMS COPYFILE command with the 
REPLACE option. Then, erase the AUTOSAVE file and resume editing. 
COPYFILE will keep any SFS authorities and aliases associated with the 
original file. 

Another way to recover your changes after a system crash is to erase the original 
file and rename the AUTOSAVE file to the original file; however, this method 
will cause you to lose any SFS authorities and aliases associated with the 
original file. 

4. To recover from an erroneous change to the file, for example, a bad global 
change, you should immediately issue a QUIT subcommand, replace the original 
file with the AUTOSAVE file by using the REPLACE option of the CMS 
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SET AUTOSAVE 



COPYFILE command, erase the autosave file, and continue. However, if the 
ALT count in the file identification line is 0, the erroneous change has already 
been saved and this technique will not recover firom it, 

5. While an XEDIT macro is executing, the automatic save won't be performed. 
The autosave will be done when the macro completes execution. 

6. The automatic save function requires that the file mode be accessed as 
read/write. Thus, even though you may XEDIT files in another user's directory, 
the AUTOSAVE file must be targeted for one of your own directories or 
minidisks. 

Notes for Macro Writers 

You can use the EXTRACT/ AUTOSAVE/ subcommand to return the autosave 
information for further processing by a macro. 



Responses 



Each time an automatic save occurs, the editor writes the file to your file mode A 
(or the mode specified in the SET AUTOSAVE subcommand). It assigns the file a 
unique numerical file name and a file type of AUTOSAVE. QUERY UNIQUEID 
displays the unique AUTOSAVE file name. 

The identifier has the form rrrnnnnn where rrr is the number of times XEDIT was 
called recursively and nnnnn is the current autosave number. Note that when the 
recursion level, rrr, is less than 100, the leading zero(es) will be dropped. 
Consequently, the file name can have as many as eight digits or as few as six, 
depending on the recursion level. 

If no other AUTOSAVE file exists, the file name and file type are: 
100001 AUTOSAVE 

In this example, the left-most 1 is the recursion level and the right-most 1 is the 
current autosave number. 

If an AUTOSAVE file exists, the file name is the next available number. 

When an autosave occurs, the following message is displayed: 

5101 Autosaved as fn ft fm 



Messages 



037E Filemode mode is accessed as read/only [RC = 12] 

048E InvaUd mode mode [RC = 24] 

069E Filemode mode not accessed [RC = 36] 

520E Invalid operand: operand [RC = 5] 

545E Missing operand(s) [RC = 5] 



Return Codes 



Normal 

5 Missing or invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 

12 Mode is read only 

24 InvaUd file mode 

36 Corresponding mode is not accessed 
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SET BRKKEY 



Format 



Use the SET BRKKEY option to inform the editor whether CP should break in 
when the "BRKKEY" (defined by CP TERMINAL BRKKEY) is pressed. 




Operands 



ON 



indicates that pressing the key defined as the BRKKEY causes a control 
break-in by CP. If you set BRKKEY ON without assigning it to a specific key, 
then XEDIT sets BRKKEY ON PAl by default. 



OFF 



key 



indicates that no control break-in is desired and that XEDIT can use the 
definition of the key that was depressed. You can then use this key in XEDIT 
as it has been defined by the SET PFn or SET PAn subcommand. 

is the PAl key or any PF key (1-24). PAl is the default. Be sure that the key 
you specify is available on the terminal you are using. 



Initial Setting 
Usage Notes 



Messages 



Return Codes 



Defined by the CP BRKKEY setting. 



1. The BRKKEY is initially defined by CP as the PAl key. To define a 
BRKKEY, see the TERMINAL command in the VM/SP CP General User 
Command Reference. 

2. Issuing the editor SET BRKKEY subcommand changes the CP TERMINAL 
BRKKEY setting. (The new setting remains in effect after you leave the XEDIT 
session). 

3. If the BRKKEY is set to ON and you enter full-screen CMS, the BRKKEY 
setting is changed to OFF. 



520E Invalid operand: operand [RC = 5] 
525E InvaUd PF/PA key number [RC = 5] 
545E Missing operand(s) [RC = 5] 



Normal 

5 Missing or invalid operand or number 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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SET CASE 



Format 



Use the CASE option to control how letters are entered into the file, to control how 
commands are translated from the command line (whether the commands are 
entered from the terminal or from the console stack), and to specify if uppercase and 
lowercase letters are to be significant in target searches. 



[set] 


CASE Uppercase 
Mixed 


Respect 
Ignore 





Operands 



Uppercase 

indicates that the editor is to translate all lowercase letters to uppercase (whether 
the lines are entered from the terminal or from the console stack). 

Mixed 

indicates that the editor is not to translate uppercase and lowercase letters 
(whether the lines are entered from the terminal or console stack). 

Respect 

In target searches, an uppercase letter will not match a lowercase letter (and vice 
versa). For example: 

/This Text/ 

will not locate 

"this text" 

in the file. 

Ignore 

In target searches, uppercase and lowercase representations of the same letter 
will match. For example: 

locate /THIS TEXT/ 

will locate 

"this text" 

in the file. 



Initial Setting 
Messages 



Based on file type. See "Appendix A. 



520E Invalid operand: operand [RC = 5] 
545E Missing operand(s) [RC = 5] 
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Return Codes 

Normal 

5 Missing or invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called firom the last file in the ring 
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SET CMDLINE 



Format 



Operands 



Use the CMDLINE option to specify the position of the command line on the 
screen. 



[set] 


CMDline 


On 
OFf 
Top 
Bottom 



On 



defines the last two lines of the screen as the command input lines. 



OFf 



removes the command line from the screen. 



Top 

defines the second line of the screen as the command Une. 

Bottom 

defines the last line on the screen as the command input line. 



Initial Setting 
Usage Notes 



CMDLINE ON 



1. When CMDLINE is set to TOP, BOTTOM, or OFF, no XEDIT status area is 
displayed. 

2. Before setting CMDLINE OFF, you should estabUsh a method of resetting the 
CMDLINE, perhaps by setting a PF key or through the use of a prefix macro, if 
you wish to use the command line again. 

3. The command line cannot be overlay ed by a reserved line unless it is first set 
OFF. 

4. If CMDLINE ON is in effect and you split the screen vertically (see SET 
SCREEN), only one line is available as a command line when two views are 
adjacent. However, when you return to a single screen, both lines are again 
available. SET CMDLINE ON is invalid when issued from a vertical split 
screen. 

5. With CMDLINE TOP and the default SET MSGLINE setting (Une 2), a 
message overlays the command line, including the arrow. You must press the 
CLEAR key (or any key that does not produce a message) to restore the 
command line. To avoid this situation, assign the message Une to line 1 or Une 3 
(see SET MSGLINE) when using CMDLINE TOP. 

6. When SET CMDLINE is entered with the ON, TOP, or BOTTOM operands, 
the cursor will be positioned in the first column of the command Une. 
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SET CMDLINE 



Messages 



Return Codes 



520E Invalid operand: operand [RC = 5] 

526E Option option valid in display mode only [RC = 3] 

545E Missing operand(s) [RC = 5] 

568E Subcommand not valid with this screen definition [RC = 5] 



Normal 

3 Operand is valid only for display terminal 

5 Missing or invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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SET COLOR 



Format 



Operands 



Use the COLOR option to associate specific colors with certain areas of the XEDIT 
screen. 




indicates all of the fields Usted below. 



field 



can be any of the following areas on the screen. 

Arrow 

the arrow pointing to command line. 

Cmdline 

the line where commands are entered. 

CUrUne 

the file line that is the current line. 

Filearea 

file data area, excluding the current line, the TOF and EOF Unes. 

Idline 

the file identification line on line 1 of the screen. 

Msgline 

the area used to display messages. 

Pending 

the pending macro or subcommand as entered in the prefix area. 

PRefix 

the five-position area that lies either to the left or the right of each line of 
the file, as defined by SET PREFIX. 

Scale 

the scale line. 

SHadow 

shadow line(s) resulting from selective line editing (See Appendix B.) 

STatarea 

status area in lower right-hand corner of screen which displays the current 
status of your editing session. 

Tabline 

the Une which displays a "T" in every tab column, according to the current 
tab settings. 
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TOfeof 

the top of file and end of file notices. 

color 

can be any one of the following: 



Blue 


Turquoise 


Red 


Yellow 


Pink 


White 


Green 


Default. 



If you omit color, the current color is not changed. 



exthi 



extended highlighting can be any one of the following: 

BLInk 

REVvideo (reverse video) 

Underline 

NONe. 

If you omit exthi, the current extended highlighting setting is not changed. 

High 

field is to be displayed highlighted 

Nohigh 

field is to be displayed not highhghted (normal intensity) 

If you omit High|Nohigh, the current High|Nohigh setting is not changed. Note 
that High|Nohigh is affected by usage note 1. 

PSs 

specifies the programmed symbol set to be used. PSO indicates that the default 
character set should be used. PSs can be any of the following: 



PS0 


PSD 


PSA 


PSE 


PSB 


PSF 


PSC. 





Initial Settings 



FIELD 



COLOR EXTHI HI6H/N0HI6H PSs 



ARROW 


DEFAULT 


NONE 


HIGH 


PSO 


CMDLINE 


DEFAULT 


NONE 


NOHIGH 


PSO 


CURLINE 


DEFAULT 


NONE 


HIGH 


PSO 


FILEAREA 


DEFAULT 


NONE 


NOHIGH 


PSO 


IDLINE 


DEFAULT 


NONE 


HIGH 


PSO 


MSGLINE 


RED 


NONE 


HIGH 


PSO 


PENDING 


DEFAULT 


NONE 


HIGH 


PSO 


PREFIX 


DEFAULT 


NONE 


NOHIGH 


PSO 


SCALE 


DEFAULT 


NONE 


HIGH 


PSO 


SHADOW 


DEFAULT 


NONE 


NOHIGH 


PSO 


STATAREA 


DEFAULT 


NONE 


HIGH 


PSO 


TABLINE 


DEFAULT 


NONE 


HIGH 


PSO 


TOFEOF 


DEFAULT 


NONE 


NOHIGH 


PSO 
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Usage Notes 



1 . The SET COLOR subcommand accepts the color, extended highlighting, and 
programmed symbol set operands regardless of whether or not the device has the 
ability to use those attributes. However, the action taken is dependent upon the 
device. For example, HIGH and NOHIGH are ignored on a 3279 display 
(unless the color was DEFAULT), color is ignored on a 3278 display, and color, 
extended highUghting, and character set are ignored on a 3277 display. Also, 
QUERY and EXTRACT return all the current settings, even those that may be 
ignored on any given terminal. 

2. The attributes following the field keyword can appear in any order. Only one 
attribute is required following the field. 

3. If TOFEOF is set off (see SET TOFEOF in this pubUcation), the extended 
highlighting attributes (reverse video and underline) still will be visible. 

4. The color and extended highlighting of the current line override the color and 
extended highlighting of the filearea and TOFEOF for any line that is the 
current line. 

5. The color and extended highlighting of the scale override the color and extended 
highUghting of the tabline when the scale and tabline are on the same line, 

6. On 3270 terminals equipped with the Programmed Symbol (PS) feature you can 
specify alternate character sets to be used on your terminal. The characters in 
these sets use different symbols, such as a different style or font, than the default 
character set. 

New character sets are loaded using the Graphic Data Display Manager 
(GDDM) program product (5748-XXH) or an application that loads 
programmed symbol sets. During the loading of programmed symbol sets, 
symbol set identifiers (SSIDs) are specified by the user. In XEDIT, the 
allowable SSIDs are in the decimal range 193 through 198. These SSIDs 
correspond to PSA through PSF, respectively (that is, 193 to PSA). Character 
sets should be loaded before invoking XEDIT. If a new set is loaded, it will not 
be recognized and the last character set loaded prior to invoking the editor will 
be displayed. Likewise, if you drop a programmed symbol set, the editor is not 
aware that the set is no longer available and attempts to use that set. This may 
cause I/O errors when the display is written (resulting in SET TERMINAL 
TYPEWRITER). To avoid problems, do not load or delete program symbol 
sets when in the XEDIT environment. 



Messages 



Return Codes 



520E Invalid operand: operand [RC = 5] 
545E Missing operand(s) [RC = 5] 



Normal 

5 InvaUd or missing operand(s) 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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SET COLPTR 



Format 



Operands 



Initial Setting 
Usage Note 

Messages 

Return Codes 



Use the COLPTR option only with typewriter terminals to control whether or not 
the column pointer (represented as an underscore character) is displayed. 




ON 



displays the column pointer. 



OFF 



removes the column pointer from the display. 



COLPTR ON (typewriter terminals only) 



In order for the column pointer to be displayed, your typewriter terminal must be 
equipped with a backspace key. 



520E Invalid operand: operand [RC = 5] 
545E Missing operand(s) [RC = 5] 



Normal 

5 Missing or invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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SET CTLCHAR 



Use the CTLCHAR option to define a control character, which specifies that part of 
a reserved line is to be displayed with or without the following features: 

• Color 

• Extended highlighting 

• HighUghting 

• Programmed symbol set 

• Protection 

• VisibiUty. 

This option is designed to be issued from a macro, particularly when you are 
creating display panels and other interactive information. It applies to lines reserved 
by the SET RESERVED subcommand. 



Format 



SET 



CTLchar char Escape 
OFF 

Protect [color] [exthi] [High I Nohieh I Invisible! [PSs] 
Noprotect [color] [exthi] [High INohighl Invisible! 'PSsI 
OFF 



Operands 



char 



is any character, uppercase or lowercase, which is interpreted as a control 
character when embedded in the text to be displayed. If specified with the 
ESCAPE operand, this character identifies the next character in the text as a 
control character. No more than 63 characters can be defined. 

OFF 

resets all control characters that have been defined (SET CTLCHAR OFF), or 
resets a specified character (SET CTLCHAR char OFF). 

Escape 

specifies that the designated character (char) is a control character identifier; that 
is, when this character appears in the text, the next character in the text is 
interpreted as a control character. 

Protect 

specifies that the string following "char" is to be displayed in a protected field. 

Noprotect 

specifies that the string following "char" is to be displayed in an unprotected 
field. 

color 

color can be any one of the following: 

Blue Turquoise 

Red Yel 1 ow 

Pink White 

Green Default. 
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SET CTLCHAR 



If you omit color, the default is DEFAULT (the default base color). 



exthi 



extended highlighting can be any one of the following: 

BLInk 

REVvideo - reverse video 

Underline 

NONe. 

If you omit exthi, the default is NONE (no extended highlighting). 

High 

specifies that the string following "char" is to be displayed highhghted. If you 
omit High|Nohigh|Invisible, Nohigh is assigned. 

Nohigh 

specifies that the string following "char" is to be displayed not highlighted 
(normal intensity). If you omit High] Nohigh| Invisible, Nohigh is assigned. 

Invisible 

defines a field where the characters are not displayed, for example, a password. 
If you omit High |Nohigh| Invisible, Nohigh is assigned. 



PSs 



the programmed symbol set can be any of the following: 



PSO 


PSD 


PSA 


PSE 


PSB 


PSF 


PSC. 





Initial Setting 



PSO indicates that the default character set will be used. 



No control characters are defined. CTLCHAR is set OFF. 



Notes for Macro Writers 

1 . Using control characters to specify the display within a reserved line requires 
three steps: 

• Define the control character identifier using the ESCAPE operand of SET 
CTLCHAR, 

• Define the control character with its associated features, 

• Use the SET RESERVED subcommand with the control character identifier 
and control character to specify the display within the reserved line. 

See the following "Examples" section for an example of each of these steps. 

2. If you use SET CTLCHAR to set up multiple fields within reserved lines, 
particularly input (unprotected) fields, you should use READ with the TAG 
option. Multiple fields on a single reserved line are stacked separately, and a tag 
identifying the origin of each line is inserted. For more information on using 
READ with the TAG option, see the READ subcommand. 

3. The SET CTLCHAR subcommand accepts the color, extended highlighting and 
programmed symbol set operands whether or not the terminal has the ability to 
use those attributes. However, the action taken depends upon the device. For 
example, HIGH and NOHIGH are ignored on a 3279 display (unless the color 
was DEFAULT), color is ignored on a 3278 display, and color, extended 
highlighting, and character set are ignored on a 3277 display. Also, QUERY 
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Messages 



Return Codes 



Examples 



SET CTLCHAR 



and EXTRACT return all the settings, even those that may be ignored on any 
given terminal. 

On 3270 terminals equipped with the Programmed Symbol (PS) feature you can 
specify alternate character sets to be used on your terminal. The characters in 
these sets use different symbols, such as a different style or font, than the default 
character set. 

New character sets are loaded using the Graphic Data Display Manager 
(GDDM) program product (5748-XXH) or an appUcation that loads 
programmed symbol sets. Character sets should be loaded before invoking 
XEDIT. If a new set is loaded, it will not be recognized and the last character 
set loaded prior to invoking the editor will be displayed. Likewise, if you drop a 
programmed symbol set, the editor is not aware that the set is no longer 
available and attempts to use that set. This may cause I/O errors when the 
display is written (resulting in SET TERMINAL TYPEWRITER). To avoid 
problems, do not load or delete program symbol sets when in the XEDIT 
environment. 



520E InvaUd operand: operand [RC = 5] 

545E Missing operand(s) [RC = 5] 

695E Cannot define more than 63 CTLCHARs [RC = 4] 



Normal 

4 Too many control characters defined 

5 Missing or invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 



The following subcommands are issued: 

set ctlchar ! escape 

Defines ! as a control character identifier. When ! appears in the text, the next 
character is interpreted as a control character. 

set ctlchar % protect high 

When % appears in the text, preceded by the control character identifier (!), 
the data that follows it is displayed protected and highlighted. 

set ctlchar " protect nohigh 

When " appears in the text, preceded by the control character identifier (!), the 
data that follows it is displayed protected and not highlighted. 

set ctlchar ? protect blue underline psa 

When ? appears in the text, preceded by the control character identifier (!), the 
data that follows it is protected, underlined, and displayed in blue using 
programmed symbol set A. 

set reserved 3 noh This is an !%exaniple!" of selective l?highlighting!" 

When the screen is displayed, the word "example" is highUghted on line 3 and 
the word "highlighting" is protected, underhned, and displayed in blue using 
programmed symbol set A (PSA). 
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SET CURLINE 



SET CURLINE 



Format 



Operands 



Use the CURLINE option to define the position of the current Une on the screen. 




ON 

displays the current line on the screen. 

MI + n\-n] 

specifies the line in which the current line is displayed. M stands for "middle of 
the screen" (rounded up for odd sized screens). M may be combined with a 
constant positive or negative integer to mean n lines below the middle of the 
screen (M + n), or n Unes above the middle of the screen (M — n). For example, 
CURLINE ON M means the "middle of the screen," and CURLINE ON M + 3 
means " three lines below the middle of the screen." 

[±\-\n 

specifies the line in which the current line is displayed, n or + n ( + is implicit) 
specifies that the current Une is displayed n lines from the top of screen; — n 
specifies that the current line is displayed n lines from the bottom of screen. For 
example, CURLINE ON — 3 means that the current Une is three lines from the 
bottom of the screen. 



Initial Setting 
Usage Note 



CURLINE ON M (middle of the screen) 



1. Under certain conditions, the current line as it appears on your display screen 
does not have the same Une number that you specified on the SET CURLINE 
subcommand. This occurs when the CURLINE Une setting is the same as the 
line setting for any of these SET options: 

• SET RESERVED 

• SET SCALE 

• SETTABLINE 

• SETMSGLINE 

When the CURLINE line setting is the same as the line setting for SET SCALE, 
for example, the scale occupies the specified line and the current line is moved 
down to the next available Une. 

Note: Other subcommands that refer to CURLINE (EXTRACT, for example) 
use the true current line regardless of where it happens to appear on the display 
screen. 
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SET CURLINE 



Messages 



520E Invalid operand: operand [RC = 5] 

52 IE Invalid line number [RC = 5] 

526E Option option valid in display mode only [RC = 3] 

545E Missing operand(s) [RC = 5] 



Return Codes 



Normal 

3 Operand is valid only for display terminal 

5 Missing or invalid operand or number 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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SET DISPLAY 



SET DISPLAY 



Format 



Use the DISPLAY option to specify which selection levels of hnes (as defined by 
SET SELECT) are displayed. For an illustration of how SET DISPLAY can be 
used effectively in combination with the other selective line editing subcommands 
(SET SELECT, SET SCOPE, and SET SHADOW), see SET SELECT in this 
pubUcation. 



[set] 



Display nl [n2\*] 



Operands 



Initial Setting 
Usage Notes 



Messages 



nl 



n2\-- 



is a positive whole number that represents a selection level of lines that you wish 
to display. If nl is specified alone, only the Hnes having a selection level of nl 
are included in the display. 

k 

is a positive whole number that represents a selection level of Hnes. When both 
nl and n2 are specified, all lines with selection levels between nl and n2 inclusive 
are included in the display. The value of n2 must be equal to or greater than 
that of nl. If n2 is specified as an asterisk (*), air Hnes with selection levels 
starting with nl and greater are displayed. 



DISPLAY G 



1. To display the entire file, use SET DISPLAY *. If you use "SET DISPLAY 
*," you cannot subsequently use the X prefix macro to exclude Hnes. You must 
first reset the DISPLAY level to something other than asterisk (*). 

2. For examples of this and other selective Hne editing subcommands, you can 
examine the following IBM-supplied macros: ALL (whose file ID is ALL 
XEDIT), which restricts editing to a particular set of Hnes, and the X prefix 
macro (whose file ID is PREFIXX XEDIT), which excludes Hnes from the 
display. Appendix B, "Effects of Selective Line Editing Subcommands" on 
page 405. 



520E InvaHd operand: operand [RC = 5] 
543 E InvaHd number: number [RC = 5] 
545E Missing operand(s) [RC = 5] 

600E First selection level (««) cannot be greater than second selection level (««) 
[RC = 5] 
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SET DISPLAY 



Return Codes 

Normal 

5 Missing or invalid operand or number 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 



Chapter 3. XEDIT Subcommands and Macros 227 



SET ENTER 



SET ENTER 



Format 



Use the ENTER option to define a meaning for the keyboard ENTER key or to 
remove the meaning associated with the ENTER key. 



[set] 


ENTer 


BEFORE 
AFTER 
ONLY 
. IGNORE . 




string 
NULLKEY 
COPYKEY 
TABKEY . 





Operands 



BEFORE 

specifies that the key definition is executed before the contents of the command 
Une. BEFORE is the default for SET ENTER, unless the string begins with a 
"?" or " = ." For these two strings, ONLY is the default. 

AFTER 

specifies that the key definition is executed after the contents of the command 
Une. 

ONLY 

specifies that only the key definition is executed, thereby ignoring the command 
line. 

IGNORE 

specifies that the key definition is ignored when something is entered on the 
command Une, thereby only executing the command Une. 

string 

is any XEDIT subcommand or macro (including CP, CMS, or EXEC), which is 
executed when the ENTER key is pressed. If string is null, the ENTER key will 
be undefined. 

NULLKEY 

When the ENTER key is pressed, blank characters are changed to nulls on the 
field of the screen that contains the cursor. If the cursor is on a prefix area, then 
blanks will be changed to nulls on the file line with which that prefix area is 
associated. 

TABKEY 

When the ENTER key is pressed, the cursor is moved into the next tab column, 
as defined by the SET TABS subcommand. 

COPYKEY 

When the ENTER key is pressed, the exact content of the virtual screen is 
copied into the printer spool. 
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SET ENTER 



Initial Setting 
Usage Notes 



Messages 



Return Codes 



Example 



ENTER IGNORE COMMAND CURSOR CMDLINE 1 PRIORITY 30 



1. When you use the ENTER key set to COPYKEY, you should close the printer 
at the end of the editing session. If your printer is defined as a 3203, 321 1, 3262, 
4245, or 3289e, see the VMjSP CP General User Command Reference under 
LOADVFCB for information on the default FCB. 

2. When you press the ENTER key set to TABKEY, COPYKEY, or NULLKEY, 
no screen changes are processed, including the command Une, and the keywords 
BEFORE, AFTER, ONLY, and IGNORE have no effect. A PA/PF key would 
have to be used to process the command Une and/or to change the ENTER key 
definition. 

3. ONLY as part of the ENTER key setting should be used with extreme care, 
since the command line will not be processed. A PA/PF key would have to be 
used to process the command line and/or to change the ENTER key definition. 



520E Invalid operand: operand [RC = 5] 

545E Missing operand(s) [RC = 5] 

622E Insufficient [free] storage \for copy key] [RC= 104] 



Normal 

5 Missing or invaUd operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 

104 No storage is available 



Setting the priority to 5 as shown below will prevent the cursor from moving to the 
command line if you are in the file area when the ENTER key is pressed. 

set enter ignore command cursor cmdline 1 priority 5 
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SET ESCAPE 



SET ESCAPE 



Format 



Operands 



Initial Setting 



Usage Notes 



l\/lessages 



Return Codes 



Use the ESCAPE option on a typewriter terminal to allow you to enter a 
subcommand when you are in input mode, without leaving input mode. 




ON 



turns on the use of an escape character. 



char 



specifies a character to be used. 



OFF 



turns off the use of an escape character. 



ESCAPE ON (typewriter terminal) 
ESCAPE OFF (display terminal) 

A default escape character is assigned according to file type; see "Appendix A.' 



1 . The escape character must appear in column 1 . It identifies the line being 
entered as a subcommand. 

2. The default escape character can be displayed by QUERY ESCAPE. 

3. This subcommand has no meaning on a display terminal. 

4. The escape character can be specified in hexadecimal if SET HEX ON is in 
effect. 



520E Invalid operand: operand [RC = 5] 
545E Missing operand(s) [RC = 5] 



Normal 

5 Missing or invahd operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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SET ETARBCH 



SET ETARBCH 



Format 



Operands 



Initial Setting 



Usage Notes 



Use the ETARBCH option to define an extended arbitrary character within a 
Double-Byte Character Set (DBCS) string. An extended arbitrary character used 
between two character strings in a target definition means "all intervening characters 
are to be ignored when searching for a match in the file." 




ON 



turns on the use of a double-byte special character as an extended arbitrary 
character. 



char 



specifies the double-byte character to be used as the extended arbitrary 
character. 



OFF 



turns off the use of a special character as an extended arbitrary character 
without changing the current character definition. 



The initial setting is a double-byte monetary symbol (X'425B'). 



ETARBCH OFF 
ETARBCH OFF 
ETARBCH OFF 



"]$" 



(X'425B') on a 3278 and 3279 terminal 
PC'425B*) on a 3277 terminal 
(X'425B') on a 5550 Multistation 



1 . See Appendix F for information on using DBCS strings in the XEDIT 
environment. 

2. Extended arbitrary characters can be used in targets and in the CHANGE, 
COUNT, and SPLIT subcommands. 

3. The extended arbitrary character may be specified in hexadecimal if SET HEX 
ON is in effect. 



Messages 



520E Invalid operand: operand [RC = 5] 
545E Missing operand(s) [RC = 5] 
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SET ETARBCH 



Return Codes 

Normal 

5 Missing or invalid operand(s) 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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SET ETMODE 



SET ETMODE 



Format 



Operands 



Use the ETMODE (extended mode) option to specify that XEDIT should recognize 
Double-Byte Character Set (DBCS) strings. In this mode, XEDIT can manipulate 
and display DBCS strings on terminals that support Double-Byte Character Sets. 




ON 



specifies that XEDIT will recognize and manipulate DBCS strings that begin 
with a shift-out character and end with a shift-in character. 



OFF 



specifies that all data should be treated as 1-byte EBCDIC data. 



Initial Setting 



Usage Notes 



The initial setting is based on whether the terminal can display double-byte 
characters. If it can, the initial setting is ON; if not, the setting is OFF. 



1 . If full-screen CMS is off or suspended and you disconnect from a terminal that 
supports DBCS and reconnect to a terminal that does not support DBCS, then 
the first time you enter the XEDIT command on the new terminal, ETMODE 
will be set ON. If you disconnect from a terminal that does not support DBCS 
and reconnect to a terminal that does, then the first time you enter the XEDIT 
command on the new terminal, ETMODE will be set OFF. 

2. See Appendix F for information on using DBCS strings in the XEDIT 
environment. 



Messages 



Return Codes 



520E InvaUd operand: operand [RC = 5] 
545E Missing operand(s) [RC = 5] 



Normal 

5 Invalid or missing operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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SET FILLER 



SET FILLER 



Format 



Use the FILLER option to define a character to be used by the editor when a line is 
expanded; that is, when tab characters are removed and replaced by an appropriate 
number of filler characters (see the EXPAND subcommand.) The default filler 
character is a blank. 



[set] 



FILler [char] 



Operand 

Initial Setting 
Usage Note 
Messages 

Return Codes 



char 



specifies a filler character to be used. 



The "blank" character is defined as the filler. 



The filler character can be specified in hexadecimal if SET HEX ON is in effect. 



520E Invalid operand: operand [RC = 5] 
545E Missing operand(s) [RC = 5] 



Normal 

5 Missing or invahd operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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SET FMODE 



SET FMODE 



Format 



Use the FMODE option to change the file mode of the file being edited. 



[set] 



FMode fm 



Operand 



fm 



is the new file mode. You can specify a file mode letter (A through Z) or a file 
mode letter and number (0-6). If you specify only a file mode letter, the existing 
file mode number is used. 



Usage Notes 



1 . The specified file mode is used the next time a FILE or SAVE is entered. If the 
file being edited had been written to disk or directory before, that copy of the 
file remains unchanged. 

2. If the disk or directory specified by file mode already contains a file with the 
same file name and file type and you enter FILE or SAVE, the editor displays 
an error message. 

3. If the file mode specified is that of a read-only minidisk, and you enter FILE or 
SAVE, the editor displays an error message. 

4. If you are editing a member of a MACLIB, this command will change the mode 
of the member. 



Messages 



Return Codes 



048E Invahd filemode mode [RC = 24] 

069E Filemode mode not accessed [RC = 36] 

520E Invalid operand: operand [RC = 5] 

545E Missing operand(s) [RC = 5] 

555E File fn ft fm already in storage [RC = 4] 



Normal 

4 File already in storage 

5 Missing or invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 

24 Invalid file mode 

36 Corresponding mode not accessed 
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SET FNAME 



SET FNAME 



Format 



Use the FNAME option to change the file name of the file being edited. 



[set] 



FName fn 



Operand 



Usage Notes 



Messages 



Return Codes 



fn 



is the new file name; it can be fi*om one to eight characters long. 



1 . The specified file name is used the next time a FILE or SAVE is issued. If the 
file being edited had been written to disk or directory before, that copy of the 
file remains unchanged. 

2. If a file already exists with the specified file name and the same file type and file 
mode and you issue FILE/SAVE, the editor displays an error message. 

3. If you are editing a member of a MACLIB, this command will change the 
member name. 



062E Invalid character in fileid fn ft fm [RC = 20] 

520E Invalid operand: operand [RC = 5] 

545E Missing operand(s) [RC = 5] 

555E File fn ft fm already in storage [RC = 4] 



Normal 

4 File already in storage 

5 Missing or invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 

20 Invalid character in the string proposed as file name 
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SET FTYPE 



SET FTYPE 



Format 



Use the FTYPE option to change the file type of the file being edited. 



[set] 



FType ft 



Operand 



ft 



is the new file type; it can be fi-om one to eight characters long. 



Usage Notes 



1 . The specified file type is used the next time a FILE or SAVE is issued. If the 
file being edited had been written to disk or directory before, that copy of the 
file remains unchanged. 

2. If a file already exists with the specified file type and the same file name and file 
mode and you issue FILE/SAVE, the editor displays an error message. 

3. When editing a member of a MACLIB, the file type must remain MEMBER. 



Messages 



Return Codes 



062E Invalid character in fileid fn ft fm [RC = 20] 

520E Invalid operand: operand [RC = 5] 

545E Missing operand(s) [RC = 5] 

555E File fn ft fm already in storage [RC = 4] 



Normal 

4 File already in storage 

5 Missing or invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 

20 Invalid character in the string proposed as file type 
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SET FULLREAD 



SET FULLREAD 



Format 



Operands 



initial Setting 
Usage Notes 



Use the FULLREAD option to allow recognition by XEDIT and CMS of 3270 null 
characters in the middle of screen lines. SET FULLREAD changes the CMS setting 
of the FULLREAD option. 




ON 



in combination with SET NULLS ON, enables XEDIT and full-screen CMS to 
recognize nulls in the middle of lines, allowing you to enter tabular or pictorial 
data without worrying about it being "crushed to the left." NULLS ON allows 
you to use insert mode. 



OFF 



inhibits transmission of nulls from the terminal to XEDIT. The SET NULLS 
subcommand can be used in this situation to control the relationship between 
nulls and blanks in screen data. 



Defined by the CMS setting. 



1 . When FULLREAD ON is issued, nulls at the end of screen hnes that are part of 
a logical line that occupies more than one physical screen line are dropped. This 
allows you to delete characters in a screen line and still have the line 
reconstructed flush together even though multi-line 327X lines do not "wrap" 
when the character delete key (or the insert mode key) is used. 

2. Using FULLREAD ON has performance implications. For local channel 
attached display controllers with several users taking advantage of the SET 
FULLREAD usability improvement, there is a potential for a significant 
increase in system response time. For remote attached display controllers, 
setting FULLREAD ON will result in a noticeable increase in response time. 
Additionally, due to increased line traffic, the maximum number of terminals 
that can be supported on a link may be significantly reduced. 



An alternative to using fullread is the 3274 Entry Assist option. 
Terminal Reference for more information. 



See the VMjSP 



3. Setting FULLREAD ON will prevent you from losing any screen changes when 
you press a PA key and a message is displayed on a cleared screen. 
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SET FULLREAD 



4. A certain terminal configuration, which imposes several restrictions on your 
XEDIT session, occurs when going through a VM/Passthru Facility (5749-RCl) 
(PVM) 327X Emulator link to another VM system. These PVM links can be 
identified by an 'S' to the immediate left of the nodeid in the PVM selection 
screen. The following is a list of these restrictions: 

a. The subcommand "SET FULLREAD ON" may not be used. 

b. All PA keys (except for the CP defined TERMINAL BRKKEY) are made 
non-functional. 

5. Changing the editor FULLREAD setting also changes the CMS FULLREAD 

setting. 

6. Use of the (— > ) key or any PF key set by the SET PFn TAB KEY subcommand 
creates nulls in the middle of the command input area, regardless of the SET 
NULLS setting. When FULLREAD is OFF, these nulls will be "crushed" to 
the left. When FULLREAD is ON, the nulls will be converted to blanks. 
Because these blanks are treated as user-entered characters, they could affect the 
column placement of the actual user-entered characters in the file area. 



Messages 



520E Invalid operand: operand [RC = 5] 
545E Missing operand(s) [RC = 5] 



Return Codes 



Normal 

5 Invalid or missing operand(s) 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 



Example 



If you enter the following line with NULLS ON and FULLREAD OFF, using the 
(— > ) key to move the cursor between the columns of data: 

Vermont Maine California Georgia 

the data will be "crushed" to the left as follows when you press the ENTER key. 
Nulls are not recognized in the middle of screen lines when NULLS ON and 
FULLREAD OFF are both set. 

VermontMai neCal i f orni aGeorgi a 

However, entering the same Une with NULLS ON and FULLREAD ON using the 
(— > ) key between the columns of data results in the nulls being handled as blanks 
as follows: 



Vermont 



Maine 



California 



Georgia 
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SET HEX 



SET HEX 



Format 



Operands 



Initial Setting 
Messages 

Return Codes 



Use the HEX option to allow subcommand string operands and targets to be 
specified in hexadecimal notation. The editor searches for their EBCDIC equivalent. 




ON 



allows subcommand string operands and targets to be specified in hexadecimal 
notation. 

For example: 

locate /X'C1C2C3 7 

is the same as 

locate /ABC/ 



OFF 



turns off the ability to specify string operands and targets in hexadecimal 
notation. 



HEX OFF 



520E Invalid operand: operand [RC = 5] 
545E Missing operand(s) [RC = 5] 



Normal 

5 Missing or invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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SET IMAGE 



SET IMAGE 



Format 



Operands 



Use the IMAGE option to determine the way the editor handles tab characters 
(X'05') and backspace characters (X' 16") when a Une is entered (from a terminal or 
the console stack). 




ON 



specifies that an input line is reconstructed into an exact typewriter-like image. 

Tab characters are expanded with blank (or filler) characters, according to the 
current SET TABS settings. 

Overstrikes are interpreted as corrections, the backspace acting like a character 
delete and each column being occupied by the last character typed in. For 
example: 

set tabs 2 5 10 etc. 



INPUT LINE: XB_TYBZ 

B represents a backspace character. 
T represents a tab character, 
represents an underscore character. 

AFTER PROCESSING: b bbZ 



b represents a blank 



OFF 



specifies that tab and backspace characters are to be left as they are entered. 
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SET IMAGE 



Initial Setting 
Usage Note 



Messages 



Return Codes 



Canon 

specifies that tabs are left as they are entered, that is, tabs are not expanded to 
blank (or filler) characters. 

Backspace characters may be used to produce compound characters, such as 
underscored words. 

Before a line containing backspace characters is inserted in the file, the 
characters are rearranged according to canonical order, that is, in collating 
sequence separated by backspaces. For example, 

INPUT LINE: XYZBBB 



B represents a backspace character 
represents an underscore character. 



AFTER PROCESSING: _BX_BY_BZ 

This process simplifies searches through the file for a string, because you don't 
have to know the exact order in which the characters were entered. 



Based on file type. See Appendix A, "File Type Defaults" on page 403. 



The following subcommands and macros are affected by the IMAGE setting: 

ADD (and A and I prefix subcommands) 

COMPRESS 

EXPAND 

FIND, FINDUP, NFIND, NFINDUP 

INPUT 

OVERLAY 

REPLACE 

SPLIT 

VMFOPT 

All targets 

Typing over a Une. 



520E Invalid operand: operand [RC = 5] 
545E Missing operand(s) [RC = 5] 



Normal 

5 Missing or invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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SET IMPCMSCP 



SET IMPCMSCP 



Use the IMPCMSCP option to control whether subcommands that are not 
recognized by XEDIT are transmitted implicitly to CMS and later to CP (if 
necessary) for execution. 



Format 




Operands 



ON 



specifies that subcommands not recognized by the editor are sent to CMS and 
later (if needed) to CP for execution; that is, subcommands unknown to XEDIT 
are considered to be CMS (or CP) commands. 



OFF 



specifies that unrecognized subcommands are not sent to CMS and CP. 



Initial Setting 
Messages 

Return Codes 



IMPCMSCP ON 



520E Invalid operand: operand [RC 
545E Missing operand(s) [RC = 5] 



5] 



Normal 

5 Missing or invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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SET LASTLORC 



SET LASTLORC 



Use the LASTLORC (Last Locate or Change) option within a macro to specify the 
contents of the LASTLORC buffer. 



Format 




Operand 



line 



Initial Setting 



specifies what you want saved in the LASTLORC buffer. If you omit Une, the 
LASTLORC buffer is set to nulls. 



The initial setting of LASTLORC is a null string. 



Notes for Macro Writers 

LASTLORC does not have to be set explicitly. It is normally automatically updated 
with the last user subcommand when a LOCATE, CLOCATE, CHANGE, or any 
subcommand in the FIND family is executed. 

LASTLORC provides a memory capability which can be used by a macro explicitly. 
For example, SCHANGE uses LASTLORC so that a user can repeat the last 
CHANGE or CLOCATE without having to reenter the data. Likewise a macro that 
issues a FIND or LOCATE might use this so that the user need not retype a 
command when they just want to continue a search. 



Return Codes 



Normal 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 

subcommand has been issued in a macro called from the last file in the ring 
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SET LINEND 



SET LINEND 



Format 



Operands 



Use the LINEND option to determine whether or not the editor is to recognize a 
pound sign (#) or other character as a line-end character. 




ON 



allows you to enter several adjacent subcommands, separated by the default 
character (a pound sign), or a specified character. 



char 



is the special character to be used as a line-end character. Use special characters 
such as "@", "$", or "%". Other characters such as "/", a delimiter, or 
alphabetic characters may cause problems. The default line-end character is a 
pound sign (#). 



OFF 



specifies that the editor is not to recognize a line-end character. 



Initial Setting 
Usage Notes 



LINEND ON # 



1. The line-end character may be specified in hexadecimal if SET HEX ON is in 
effect. 

2. For consecutive linend characters (for example, FILE####) and for a single 
linend character which follows the last subcommand entered (for example, 
FILE#), XEDIT stacks a null line for each Unend character minus 1. 

3. In line mode the line-end character from CP will also be recognized during your 
XEDIT session. To set the CP linend character off or redefine it, issue: 

cp terminal linend off 

or 
cp terminal linend char 

with char as your choice of CP Une-end character. (See the TERMINAL 
command in the VM/SP CP General User Command Reference for more 
information on the CP line-end symbol). 

4. If SET CASE Uppercase is in effect, the command line is uppercased before it is 
scanned for LINEND characters. This can cause commands with case-sensitive 
targets to fail to work properly when issued in conjunction with a SET CASE M 
R conunand. For example, issuing a "SET CASE M R#FIND xxx" while SET 
CASE Uppercase is in effect causes the "xxx" to be uppercased before the editor 
searches for it. 
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SET LINEND 



Messages 



Return Codes 



Examples 



520E Invalid operand: operand [RC = 5] 
545E Missing operand(s) [RC = 5] 



Normal 

5 Missing or invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 



next l#change /A/B/#TOP 
executes as: 

next 1 

change /A/B/ 
top 



246 VM/SP System Product Editor Command and Macro Reference 



SET LRECL 



SET LRECL 



Format 



Operand 



Initial Setting 
Usage Notes 



Messages 



Use the LRECL option to define a new logical record length, which is used when the 
file is written to disk or directory. 




is the logical record length. For a file with a fixed record format (F), n is the 
length of each record. For a file with a variable record format (V), n is the 
maximum record length. If you specify an asterisk (*), the logical record length 
is set to the WIDTH as defined in the XEDIT (or LOAD) command. 



Based on file type. See Appendix A, "File Type Defaults" on page 403. 



1 . The value (n) specified must be less than or equal to the value specified in the 
WIDTH operand of the XEDIT or LOAD subcommand (in the profile). 
(WIDTH is the amount of virtual storage used for any file line, regardless of its 
format on disk or directory.) 

2. If the new logical record length is smaller than the previous one, data may be 
lost when the file is written to disk or directory. A smaller logical record length 
may also create new values for zone settings, the column pointer, and the 
truncation column. The following relationships should be verified: 

ZONEl < COLUMN POINTER < Z0NE2 < TRUNC < LRECL < WIDTH 

The column pointer can also be positioned at TOL (Zonel — 1) and at EOL 

(Zone2 + 1). 

3. Refer to the LOAD subcommand for more details on the initial setting of 
LRECL during profile execution. 



5 1 6E LRECL too large for V-format file [RC = 4] 

5 1 9E LRECL must be lower than WIDTH (««) [RC = 5] 

520E Invahd operand: operand [RC = 5] 

543E Invalid number: number [RC = 5] 

545E Missing operand(s) [RC = 5] 

560E Not enough space for seriaHzation between TRUNC and LRECL 

698W New record length may result in loss of double-byte characters [RC = 3] 
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SET LRECL 



Return Codes 



Normal 

3 Records truncated 

4 Lrecl must be lower than 65536 for recfm V 

5 Missing or invalid operand or number 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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SET MACRO 



SET MACRO 



Format 



Operands 



Initial Setting 
Usage Notes 



Messages 



Return Codes 



Use the MACRO option to control the order in which the editor searches for 
subcommands and macros. 




ON 



specifies that the editor is to look for macros before it looks for subcommands. 



OFF 



specifies that the editor is to look for subcommands before it looks for macros. 



MACRO OFF 



1 . This SET option can resolve an ambiguous situation, when a macro and a 
subcommand have the same name. If the subcommand has a synonym defined, 
the macro name executes only if SYNONYM is set OFF. (See also SET 

SYNONYM.) 

2. The subcommand name SET is required with this option (to avoid conflict with 
the MACRO subcommand). 



520E Invalid operand: operand [RC = 5] 
545E Missing operand(s) [RC = 5] 



Normal 

5 Missing or invaUd operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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SET MASK 



SET MASK 



Format 



Whenever a new line is inserted in a file by a subcommand or macro, it is prefiUed 
with the contents of a mask. Initially, the mask contains all blanks. You can use 
the MASK option to change the contents of the mask. 



[set] 



MASK 



Define 

Immed [text ] 
Modify 



Operands 



initial Setting 



Define 

displays the scale in the command line to help you define a new mask. You can 
type the new mask over the scale. The size of the mask is Umited by the width 
of the screen. (If you do not type a new mask over the scale, the scale becomes 
the new mask.) 

Immed [text] 

replaces immediately the current mask by the specified text. If no text is 
specified, it replaces the current mask with a blank line. 

Modify 

displays the current mask in the command line. You can type over the mask to 
redefine it. (The scale does not appear to assist you in defining the mask, as it 
does with the DEFINE operand.) 



The initial setting of the mask is a blank line. 



Usage Notes 

1 . All subcommands and macros that insert lines in a file, prefill the new line with 
the mask. These subcommands are ADD, INPUT, and REPLACE, as well as 
the prefix subcommands A and I. The macros are SI and the prefix macro SI. 

2. You can use the QUERY MASK subcommand to display the current mask in 
the message Une, but you cannot change it. 

3. When using SET MASK DEFINE or SET MASK MODIFY to reset the mask 
to a blank line, you can press the spacebar once and then press the ERASE EOF 
key; this prevents you from clearing the mask if you accidentally press ERASE 
EOF. Pressing only the ERASE EOF key does not clear the mask. 

Note for l\/iacro Writers 

EXTRACT/MASK/ subcommand returns the current mask. 
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SET MASK 



Messages 



Return Codes 



Examples 



520E Invalid operand: operand [RC = 5] 
545E Missing operand(s) [RC = 5] 



Normal 

5 Missing or invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 



A mask is analogous to a preprinted form that has the same information on every 
line, and you type in the variable information. 
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SET MASK 



Figure 1 3 is an example of using SET MASK to define the "comments" area in a 
PLI program. 

1. Enter the following subcommand: 
====> set mask define 

2. The scale appears in the command Hne: 

====> + 1 + 2 + 3 + 4 + 5 + 6 + 7. 

+... .8. ...+... .9. ...+...1G.. ..+... 11. ...+.. .12. ...+.. .13... X E D I T 1 File 

3. Type over the scale to define the mask, deleting any scale characters. 

X E D I T 1 File 

4. If the INPUT subcommand is entered, each Hne in the input zone contains the mask: 



PROGRAM PLI 
Input mode: 



Al F 80 Trunc=72 Size=12 Line=0 Col=2 Alt=0 



* * * Top of File * * * 
!...+....l.. ..+... .2. ...+.. ..3. 



.4....+. 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 



) + 7. >.. + ... 

*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
V 

Input-mode 1 File 



Input Zone 



Figure 13. Using the SET MASK Subcommand 
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SET MSGLINE 



SET MSGLINE 



Format 



Use the MSGLINE option to define the location of the message Une on the screen, 
and the maximum number of Unes that a message may occupy. It may also be used 
to determine whether or not a blank line is normally displayed for the message line. 



[set] 



MSGLine 



ON 
OFF 



M[+n l-n] I [±\-]n [pill [Overlay] 



Operands 



Initial Setting 



ON 

allows you to receive messages at the screen location defined. 

stands for the middle of the screen (rounded up for odd-sized screens). M can be 
combined with a constant positive or negative integer to mean n lines below the 
middle of the screen (M + n) or n lines above the middle of the screen (M — n). 

{±\'\n 

indicates that the MSGLINE is located n lines from the top of the screen ( + is 
imphed/specified) or from the bottom of the screen ( — n). 

P 

is the maximum number of lines which can be used to display messages. The 
number of Unes used to display messages will not exceed the number of hnes in 
the actual messages. If the messages do not fit on p lines, the messages will be 
passed to CMS. See Usage Note I for information on displaying messages 
passed to CMS. 

Overlay 

indicates that you do not want a blank Hne on the screen for messages. If 
OVERLAY is specified, no message line is displayed unless a message is issued. 
When OVERLAY is specified, reserved lines (including the scale, tabline, etc.) 
and file Unes are displayed wherever the message Hne was defined until a 
message is issued. If OVERLAY is not specified, a blank message hne is 
displayed wherever the message line was defined. If the message line is defined 
as the same hne as the command line, the command hne overlays the blank 
MSGLINE so that a command hne is available. 



OFF 



turns off the message hne. All XEDIT messages are passed to CMS. See Usage 
Note 1 for information on displaying messages passed to CMS. 



MSGLINE ON 2 2 
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SET MSGLINE 



Usage Notes 



1. If multiple messages that do not fit on the message line(s) need to be displayed, 
or MSGLINE is set OFF, messages are passed to CMS to be displayed. 

When full-screen CMS is ON, the CMSOUT window which is connected to the 
CMS virtual screen will contain the output. (Output will appear in the 
CMSOUT window by default; you can route the output to another window by 
using the CMS ROUTE command, explained in the CMS Command Reference). 
To see all of the information in the virtual screen, you can use the CMS 
SCROLL command. The screen will be cleared automatically when you scroll 
to the bottom of the file. An alternative way to clear the screen is to issue the 
CMS DROP WINDOW command. If you delete the CMSOUT window, you 
won't see messages that are passed to CMS. 

When full-screen CMS is OFF, the screen is cleared to display the message(s). 
Press the CLEAR key to redisplay the file. No alarm sounds on either the CMS 
screen or the next XEDIT screen. 

2. The command line and MSGLINE may be the same line. If the messages 
overlay the command Une you can press the CLEAR key (or any key that does 
not produce a message) to restore the command line. 

3. When full-screen CMS is ON and messages are passed to CMS, the messages 
will be displayed with the XEDIT msgline color attributes— color, hilite, pss, etc. 



Messages 



520E Invalid operand: operand [RC = 5] 

52 IE Invahd Une number [RC = 5] 

526E Option option vahd in display mode only [RC = 3] 

545E Missing operand(s) [RC = 5] 



Return Codes 



Normal 

3 Subcommand vahd only for display terminal 

5 InvaUd or missing operand(s) or number 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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SET MSGMODE 



SET MSGMODE 



Operands 



Initial Setting 



Usage Notes 



Messages 



Use the MSGMODE option to control the message display. 
The format of the SET MSGMODE subcommand is: 




ON 

displays all messages at the terminal. 

Long 

displays all messages in their full length. 



Short 



Information (I) and warning (W) messages are not displayed. Error (E) 
messages are displayed as a NOT (-1) symbol. All other messages are displayed 
in their full length. 



OFF 



No messages or data is displayed. 



MSGMODE ON LONG (unless the NOMSG option was specified on the XEDIT 
command). 



1 . When MSGMODE is set to OFF, messages are not displayed but are still 
generated internally (in long or short form, according to the setting). However, 
you can display the last message generated by using the following sequence: 

set msgmode on 
query lastmsg 

In a macro, EXTRACT/LASTMSG/ can be used to get the last message 
generated. 

2. To enter XEDIT with the initial setting of MSGMODE OFF use the NOMSG 
option on the XEDIT or LOAD subcommand. Please refer to the XEDIT 
command in this publication for an explanation of the NOMSG option. 



520E Invalid operand: operand [RC = 5] 
545E Missing operand(s) [RC = 5] 
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SET MSGMODE 



Return Codes 

Normal 

5 Missing or invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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SET NONDISP 



SET NONDISP 



Format 



Use the NONDISP option to define for XEDIT and CMS a character to be used in 
place of nondisplayable characters. 



[set] 



NONDisp [char] 



Operand 

Initial Setting 
Usage Notes 



char 



Messages 



specifies a character to be used. If not specified, a blank will be used. 



Defined by the CMS setting. 



1 . The nondisplayable character may be specified in hexadecimal if SET HEX ON 
is in effect. 

2. Setting a nondisplayable character to a visible one, for example, SET NONDISP 
", is helpful when doing full screen changes on display terminals. When 
changing lines on the display, XEDIT tries to preserve nondisplayable characters 
within modified lines by comparing the line returned from the terminal with its 
old contents. This may lead to unexpected changes, particularly if the DELETE 
or INSERT keys are used. 

3. The NONDISP character specified must be a display able character. 
Nondisplayable characters are ignored. 

4. If you issue CMS SET NONDISP while in XEDIT, the new nondisplayable 
character will not appear in a line containing nondisplayable characters until 
that Hne is altered. Similarly, if you issue CMS SET OUTPUT while in XEDIT, 
the changed character won't appear until the line containing the character(s) to 
be changed is altered. 

5. The translation of the nondisplayable character depends upon the type of 
terminal and whether or not SET APL ON or SET TEXT ON is in effect. See 
the VMjSP Terminal Reference for the nondisplayable character translation 
tables. 

6. Changing the editor NONDISP setting also changes the CMS NONDISP 
setting. 



520E InvaUd operand: operand [RC = 5] 
545 E Missing operand(s) [RC = 5] 
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SET NONDISP 



Return Codes 

Normal 

5 Missing or invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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SET NULLS 



SET NULLS 



Format 



Operands 



Initial Setting 
Usage Notes 



Messages 



Return Codes 



Use the NULLS option to specify whether traihng blanks in each hne are written to 
the screen as blanks (X'40') or nulls (X'OO'). 




ON 



specifies that all trailing blanks are to be replaced with nulls. This allows you to 
use the insert key on the IBM 3270 keyboard to insert characters in a Hne. 



OFF 



specifies that trailing blanks are not to be replaced with nulls. The insert key 
cannot be used to insert characters in a line unless the ERASE EOF key first is 
used to remove at least as many trailing blanks as characters to be inserted. 



NULLS OFF 



1 . You can use any key defined as "NULLKEY" instead of issuing SET NULLS 
ON if you wish to use the insert key for only one line. The "NULLKEY" 
function sets nulls on in the field that contains the cursor. If the cursor is on a 
prefix area, then blanks will be changed to nulls on the file hne with which that 
prefix area is associated. If you move the cursor to another field and wish to 
use insert mode, you must press the key defined as "NULLKEY" again. 
"NULLKEY" is initially assigned by the editor to the PA2 key. 

2. If either the WIDTH option on the XEDIT command or a SET VERIFY 
subcommand are set to a value less than the screen width, you can use the insert 
key to insert characters with SET NULLS OFF. 

3. See also SET FULLREAD. 



520E Invahd operand: operand [RC ■■ 
545E Missing operand(s) [RC = 5] 



5] 



Normal 

5 Missing or invahd operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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SET NUMBER 



SET NUMBER 



Format 



Use the NUMBER option to specify whether or not file hne numbers are to be 
displayed in the prefix area. 




Operands 



ON 



causes a five-digit line number to be displayed in the prefix area of the lines. 
The line numbers are sequential and are recomputed when lines are added or 
deleted. 



OFF 



Initial Setting 
Messages 

Return Codes 



causes five equal signs (= = = = =) to be displayed in the prefix area of each 
line, unless the prefix area has been set to NULLS. (Refer to SET PREFIX in 
this pubhcation.) 



NUMBER OFF 



520E Invahd operand: operand [RC = 5] 
545E Missing operand(s) [RC = 5] 



Normal 

5 Missing or invahd operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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SET PAn 



Format 



SET PAn 



Use the PAn option to define a meaning for a specified hardware attention (PA) key 
or to remove the meaning associated with the specified PA key. 



[set] 


PAn 


BEFORE 
AFTER 
ONLY 
IGNORE 




string 
NULLKEY 
COPYKEY 
TABKEY 





Operands 



specifies a PA key number (1,2, or 3). If SET PAn is issued (without an 
additional operand), the meaning associated with that PA key is removed. 

BEFORE 

specifies that the key definition is executed before the contents of the command 
line. BEFORE is the default for all the keys, unless the string begins with a "?" 
or " = ." For these two strings, ONLY is the default. 

AFTER 

specifies that the key definition is executed after the contents of the command 
line. 

ONLY 

specifies that only the key definition is executed, thereby ignoring the command 
Une. 

IGNORE 

specifies that the key definition is ignored when something is entered on the 
command line, thereby only executing the command line. 

string 

is any XEDIT subcommand or macro (including CP, CMS, or EXEC), which is 
executed when the PA key is pressed. If string is null, the PA key will be 
undefined. 

NULLKEY 

When the corresponding PA key is pressed, blank characters are changed to 
nulls on the field of the screen that contains the cursor. If the cursor is on a 
prefix area, then blanks will be changed to nulls on the file line with which that 
prefix area is associated. 

TABKEY 

When the corresponding PA key is pressed, the cursor is moved into the next tab 
column, as defined by the SET TABS subcommand. 

COPYKEY 

When the corresponding PA key is pressed, the exact content of the virtual 
screen is copied into the printer spool. 
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SET PAn 



Initial Setting 



SET PAl BEFORE COMMAND CMS POP WINDOW 
SET PA2 BEFORE NULLKEY 
SET PAS ONLY ? 



Usage Notes 



1 . You can assign a sequence of subcommands to a single PA key by: setting off 
the LINEND character; setting the PA key to the subcommands separated by 
LINEND characters; then setting the LINEND character back on before using 
the PA key. 

For example: 

set linend off 
set pa2 next#c/A/B 
set linend on # 

2. If a PA key set to TABKEY is pressed and there are no tab columns available 
on the screen, the position of the cursor remains unchanged. 

3. PA keys may be used in input mode. (See the "Usage Notes" section of the 
INPUT subcommand.) 

4. When you use a PA key set to COPYKEY, you should close the printer at the 
end of the editing session. If your printer is defined as a 3203, 3211, 3262, 4245, 
or 3289e, refer to the VM/SP CP General User Command Reference under 
LOADVFCB for information on the default FCB. 

5. When you press a PA key set to TABKEY, COPYKEY, or NULLKEY, no 
screen changes are processed including the command Une and the keywords, 
BEFORE, AFTER, ONLY, and IGNORE, have no effect. 

6. Setting FULLREAD ON will prevent you from losing any screen changes when 
you press a PA key and a message is displayed on a cleared screen. 

7. The setting of the CP break key (PAl by default) overrides any later defined 
editor setting unless SET BRKKEY OFF is specified. 



Messages 



Return Codes 



520E Invalid operand: operand [RC = 5] 

525E Invalid {PFkey|PFkey/PAkey} number [RC = 5] 

545E Missing operand(s) [RC = 5] 

6 HE Screen modifications lost. See SET FULLREAD to use PAkeys safely. 

[RC = 8] 

622E Insufficient [free] storage for copy key [RC = 104] 

657E Undefined PFkey/PAkey 



104 



Normal 

Missing or invahd operand or number 

Subcommand rejected in the profile due to LOAD error, or QUIT 

subcommand has been issued in a macro called from the last file in the ring 

Modifications lost because PA key pressed when message pending 

No storage is available 
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SET PACK 



Format 



Operands 



SET PACK 



Use the PACK option to specify whether or not the editor is to pack the file when it 
is written to disk or directory. 




ON 



specifies that the editor is to compress records in a file so that they can be stored 
in packed format when a FILE or SAVE subcommand is issued. 



OFF 



specifies that the editor is not to pack the file when it is written to disk or 
directory. 



Initial Setting 



Usage Notes 



According to the format of the file edited. PACK ON if the file is in packed format; 
PACK OFF if the file is not in packed format. 



1 . When an XEDIT command is issued for a file in packed format on disk or 
directory, the editor automatically issues a SET PACK ON subcommand. Thus, 
when the file is filed or saved, it will be in packed format when it is written back 
to disk or directory. 

2. The PACK option is compatible with the PACK option of the CMS 
COPYFILE command. A file can be packed (or unpacked) using either the 
editor SET PACK subcommand or the CMS COPYFILE command. 

3. A file in packed format should not be modified in any way while it is on disk or 
directory (for example, a PUT subcommand would append data to a file while it 
is on disk or directory). If such a file is modified, neither XEDIT nor the CMS 
COPYFILE command will be able to reconstruct the file. 



Responses 



Messages 



The editor displays the record format in the IDLINE as: 

FP (fixed packed) 

or 

VP (variable packed) 



520E InvaUd operand: operand [RC = 5] 
545E Missing operand(s) [RC = 5] 



Chapter 3. XEDIT Subcommands and Macros 263 



SET PACK 



Return Codes 

Normal 

5 Missing or invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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SET PENDING 



SET PENDING 



Format 



Use the PENDING option to control the execution of a prefix macro and the status 
of the screen while the prefix macro is being executed. This option, designed to be 
issued from a macro, can be used to display a prefix subcommand or macro in the 
prefix area of the current hne, or to indicate to the user that a prefix subcommand 
or macro that was entered is the beginning or end of a block. In both cases, the 
screen is placed in a pending status (described in the notes below). SET PENDING 
can also be used to notify the user that a prefix macro was entered incorrectly. 



[set] 



PENDing 



ON 

BLOCK 
ERROR 
OFF 



string 
string 
string 



Operands 



ON string 

displays "string", which can be any prefix subcommand or macro, in the prefix 
area of the current line and displays a pending notice in the status area 
(described in the notes below). By default, the string in the prefix area is 
highHghted. This form of SET PENDING adds an entry to the "pending hst" 
(list of pending prefix subcommands and macros), which is described in the 
notes below. 

BLOCK string 

displays "string", which is the block form of any prefix subcommand or macro 
(for example, DD is the block form of the D prefix subcommand) in the prefix 
area of the line in which it was entered and displays a pending notice in the 
status area (described in the notes below). By default, the string in the prefix 
area is highHghted. This form of SET PENDING is used to notify the user that 
the beginning (or end) of a block was entered. The string would normally be the 
same as that entered by the user, as determined by the macro. This form of SET 
PENDING adds an entry to the "pending Ust," which is described in the notes 
below. 

ERROR string 

specifies that the string is to be displayed in the prefix area, prefixed by a 
question mark (?). By default, the string in the prefix area is highlighted. This 
indicates that an error occurred while a prefix macro (or subcommand) was 
executing, for example, if the macro was entered incorrectly. The string would 
normally be the incorrectly-entered prefix macro, as determined by the prefix 
macro, so that the user could correct the error. 

Because this entry in the pending list is deleted the next time the list is processed, 
pressing the ENTER key while "? string" is displayed resets the prefix area. 
(This prevents subsequent attempts by the user to execute an incorrect prefix 
subcommand or macro.) This form of SET PENDING does not cause a 
pending notice to be displayed. 
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SET PENDING 



OFF 

removes a pending prefix subcommand or macro from the prefix area of the 
current line (that is, removes this entry from the pending list), and resets the 
prefix area and the status area. 

Notes for Macro Writers 

1. The "pending Ust" is a Ust of prefix subcommands and macros that have not yet 
been executed. Every time the editor reads the screen, the pending list is 
updated with any new prefix subcommands and macros, each of which causes an 
entry to be added to the list. Each entry is associated with a specific line in the 
file. The pending list is executed when it is updated. If a prefix macro returns a 
non-zero return code, execution of the pending list stops and all entries not 
executed remain pending, until the user presses a key. 

An entry is deleted from the pending Hst when it is executed or overtyped on the 
user's screen with a new prefix subcommand, prefix macro, or blanks. An entry 
can also be added by using "SET PENDING ON string" and deleted by issuing 
"SET PENDING OFF" or the RESET subcommand. 

A prefix macro can control its execution and the screen status by examining 
information in the pending list (by using EXTRACT /PENDING. . ./) and by 
examining the argument string that is automatically passed to a prefix macro 
when it is invoked. The argument string contains information pertinent to the 
prefix macro when it is called, for example, the file hne of the prefix area in 
which it was entered. For a description of this argument string, see the VMjSP 
System Product Editor User's Guide. The macro can then take appropriate 
action, which may include using some form of SET PENDING. 

2. On display terminals, the pending status is indicated by the following notice in 
the status area: 

'value' pending... 

where "value" is the name of the pending prefix macro or subcommand that was 
entered in the prefix area. If multiple prefix subcommands or macros are 
pending, the first one (starting from the top of file) is displayed in the pending 
notice. 

3. After all the prefix subcommands and macros in the pending list are processed, 
the current line is restored to what it was before processing. Therefore, a prefix 
macro does not usually need to be concerned with restoring the current line. 
However, a macro can issue "SET PENDING ON /" to specify which Une is 
current when it is finished executing. (When multiple "/" prefix subcommands 
are entered, the last one executed sets the current line.) 

4. When a macro or subcommand is first put in the pending hst, it is checked (via 
the CMS STATE command) to see if it exists. If it does not exist, it is left 
pending. Creating the macro will not cause the pending macro to be 
automatically executed. You must reenter it into the prefix area for it to be 
executed. 

5. When the pending hst is executed it is scanned for SCALE, TABL, and / prefix 
subcommands after all the other prefix subcommand and macros have been 
executed. SCALE, TABL, and / are executed in the logical screen in which they 
were issued (not just on the screen in which the pending list was executed). 
Because they are executed after the rest of the pending hst is processed, a prefix 
macro may specify them and they may be executed before the screen is 
redisplayed (this is particularly useful for setting the current hne from a prefix 
macro). When multiple SCALE, TABL, and / prefix subcommands are issued. 
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Messages 



Return Codes 



Examples 



SET PENDING 



only the last one issued is used. If the last TABL or SCALE is specified on a 
line that does not fall on the screen, then it is ignored. 

6. For more information on the pending list and writing prefix macros, 
see the subcommands EXTRACT/QUERY PENDING, and 
SET/EXTRACT/QUERY PREFIX SYNONYM. For information on 
IBM-supplied prefix macros, see "Chapter 4: Prefix Subcommands and 
Macros." For tutorial information on writing prefix macros and examples of 
how to use SET PENDING in prefix macros, see the VM/SP System Product 
Editor User's Guide. 



520E Invalid operand: operand [RC = 5] 
545E Missing operand(s) [RC = 5] 



Normal 

5 Missing or invaUd operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 



set pending on A 

adds an entry to the pending list and displays A = = = = in the prefix area of the 
current Une and the notice "'A' pending. . ." in the status area. 

:3 set pending off 

removes the current hne from the pending list, that is, makes line 3 the current hne 
and resets the prefix area and the status area. 

:10 set pending error XX20 

makes line 10 the current line and displays ?XX20 in the prefix area. (XX20 is an 
invalid form of the X prefix macro.) 

:10O set pending block XX 

makes line 100 the current hne and displays "XX" in the prefix area (highlighted), 
and displays "'XX' pending. . ."in the status area. 

Assuming this was issued from a prefix macro note that : 100 is an absolute hne 
number target. It is used to make this hne current for the SET PENDING 
subcommand, which operates on the current hne. Because the current line is 
restored after the pending hst is executed (see notes, above), the block form of the 
macro is displayed in the prefix area of the line in which it was entered (which is not 
necessarily the current hne). 

Therefore, if "XX" is entered on line 100 of the file, and line 100 is not the current 
line, :100 makes hne 100 current for the SET PENDING subcommand. However, 
because the current hne is restored after execution, the user sees "XX" displayed in 
hne 100, where it was entered. 
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SET PFn 



Format 



Use the PFn option to define a meaning for a specified liardware program function 
(PF) key or to remove the meaning, if any, associated with the specified PF key. 



[set] 


PFn 


BEFORE 
AFTER 
ONLY 
IGNORE 




string 

NULLKEY 
COPYKEY 
TABKEY 





Operands 



specifies a PF key number (n can be 1 through 24). If SET PFn is issued 
(without an additional operand), the meaning associated with that PF key is 
removed. 

BEFORE 

specifies that the key definition is executed before the contents of the command 
line. Before is the default for all the keys, unless the string begins with a "?" or 
" = ." For these two strings, "ONLY" is the default. 

AFTER 

specifies that the key definition is executed after the contents of the command 
line. 

ONLY 

specifies that only the key definition is executed, thereby ignoring the command 
line. 

IGNORE 

specifies that the key definition is ignored when something is entered on the 
command line, thereby only executing the command line. 

string 

is any XEDIT subcommand or macro (including CP, CMS, or EXEC), which is 
executed when the PF key is pressed. If string is null, the PF key will be 
undefined. 

NULLKEY 

When the corresponding PF key is pressed, blank characters are changed to nulls 
on the field of the screen that contains the cursor. If the cursor is on a prefix 
area, then blanks will be changed to nulls on the file line with which that prefix 
area is associated. 

TABKEY 

When the corresponding PF key is pressed, the cursor is moved into the next tab 
column, as defined by the SET TABS subcommand. 

COPYKEY 

When the corresponding PF key is pressed, the exact content of the virtual 
screen is copied into the printer spool. 
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SET PFn 



Initial Setting 



Usage Notes 



Messages 



SET PFGl 
SET PF02 
SET PF03 
SET PFG4 
SET PF05 
SET PFG6 
SET PF07 
SET PF08 
SET PF09 
SET PF10 
SET PFll 
SET PF12 



BEF0RE 

BEFORE 

BEFORE 

BEFORE 

BEFORE 

ONLY 

BEFORE 

BEFORE 

ONLY 

BEFORE 

BEFORE 

BEFORE 



HELP MENU 
SOS LINEADD 
QUIT 
TABKEY 
SCHANGE 6 

7 

BACKWARD 
FORWARD 

RGTLEFT 
SPLTJOIN 
CURSOR HOME 



Note: These are the initial settings. On a terminal equipped with 24 PF keys, PF 
keys 13 through 24 have the same values as PF keys 1 through 12 as discussed here, 
except PF key 17 which is set to BEFORE SCHANGE 18. 



1 . You can assign a sequence of subcommands to a single PF key by: setting off 
the LINEND character; setting the PF key to the subcommands separated by 
LINEND characters; then setting the LINEND character back on before using 
the PF key. 

For example: 

set linend off 
set pf3 next#c/A/B 
set linend on # 

2. If a PF key set to TABKEY is pressed and there are no tab columns available 
on the screen, the position of the cursor remains unchanged. 

3. To get the same effect as a CP SET PF DELAY, use: 
set pf/7 cmsg.. . 



4. PF keys may be used in input mode. 
INPUT subcommand.) 



(See the "Usage Notes" section of the 



When you use a PF key set to COPYKEY, you should close the printer at the 
end of the editing session. If your printer is defined as a 3203, 321 1, 3262, 4245, 
or 3289e, refer to the VM/SP CP General User Command Reference under 
LOADVFCB for information on the default FCB. 

When you press a PF key set to TABKEY, COPYKEY or NULLKEY, no 
screen changes are processed including the command line, and the keywords 
BEFORE, AFTER, ONLY and IGNORE have no effect. 



520E Invahd operand: operand [RC = 5] 

525E Invalid {PFkey|PFkey/PAkey} number [RC = 5] 

545E Missing operand(s) [RC = 5] 

622E Insufficient [free] storage for copykey [RC = 104] 

657E Undefined PFkey/PAkey 
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SET PFn 



Return Codes 

Normal 

5 Missing or invalid operand or number 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 

104 No storage is available 
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SET POINT 



SET POINT 



Format 



Use the POINT option to define a symbolic name for the current hne. More than 
one name can be defined for a line by issuing separate SET POINT subcommands. 
You can use these names to refer to the line in subsequent target operands of 
XEDIT subcommands. 



[set] 



Point .symbol [OFF] 



Operands 



.symbol 

is a symbolic name for the current line. The name must begin with a period and 
be followed by from one to eight alphanumeric or special characters, for 
example, .AAA. 



OFF 



deletes the specified symbol, without moving the line pointer. The symbol to be 
deleted must be specified in front of this operand. 



Usage Notes 



1 . The POINT option makes it unnecessary for you to remember or to look up the 
line number of a line. A line can be referenced by its name at any time during 
the editing session. For example, if the following subcommand is issued: 

set point .XAVIER 

the current line is assigned the specified name. 

The name can then be referenced at any time during the editing session. For 
example: 

move 3 .XAVIER 

moves three lines, beginning with the current line, after the line named 
.XAVIER. 

2. The hne number of a hne can change during an editing session; for example, 
adding lines before a particular line increments its line number. The symbolic 
name, however, stays with a line for the entire editing session. 

3. The .xxxx prefix subcommand can also be used to assign a symbolic name to a 
hne. In this case, the symboUc name is limited to four characters. 

4. You can use the QUERY POINT subcommand to display the symbohc name(s) 
of the current line. You can use QUERY POINT * to display all symbohc 
names and their hne numbers as they have been defined. 
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SET POINT 



Notes for Macro Writers 

The EXTRACT/POINT/ subcommand returns the symbolic name(s) and line 
number of the current line and EXTRACT/POINT */ returns the symbolic names 
and their Une numbers in the file. 



Messages 



520E Invalid operand: operand [RC = 5] 

539E Named line not found [RC = 2] 

540E Name already defined on line nn [RC ■■ 

54 IE InvaUd name [RC = 5] 

545E Missing operand(s) [RC = 5] 



1] 



Return Codes 



Normal 

1 Duplicate name defined 

2 Name does not exist for OFF function 

5 Missing or invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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SET PREFIX 



Format 



Use the PREFIX option to control the display of the prefix area, or to define a 
synonym for a prefix subcommand. 



[set] 



PREfix ON [LeftlRight] 

OFF 
Nulls [LeftlRight] 



PREfix 



Synonym newname oldname 



Operands 



initial Setting 



ON 

displays a five-character prefix area (= = = = =) for each logical hne on the 
screen. The prefix area can be displayed on either the left (LEFT operand) or 
right (RIGHT operand) side of the screen. Prefix subcommands and macros can 
then be entered in the prefix area. 

OFF 

removes the prefix area from the screen. 

Nulls 

displays nulls in the prefix area enabhng the use of the insert key. 

Synonym 

is the keyword operand that indicates a synonym is to be defined for a prefix 
subcommand or macro. 

newname 

is a synonym to be assigned to a prefix subcommand or macro. The new name 
can be up to five alphabetic or special characters. 

oldname 

is the name of a prefix subcommand or macro for which you are defining a 
synonym. The oldname can be up to eight characters. 



PREFIX ON LEFT 



There are eight prefix synonyms defined. 



> 


PRFSHIFT 


» 


PRFSHIFT 


< 


PRFSHIFT 


« 


PRFSHIFT 


X 


PREFIXX 


XX 


PREFIXX 


s 


PRFSHOW 




SI 
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Usage Note 

When using SET PREFIX ON with SET NUMBER ON, a five-digit line number is 
displayed instead of equal signs. When using SET PREFIX NULLS with SET 
NUMBER ON, any leading zeros are translated to nulls. 

Messages 

520E InvaUd operand: operand [RC = 5] 

545E Missing operand(s) [RC = 5] 

548E Invalid synonym operand: operand [RC = 5] 

Return Codes 

Normal 

5 Missing or invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called fi-om the last file in the ring 
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SET RANGE 



SET RANGE 



Format 



Operands 



Use the RANGE option to define new limits for line pointer movement. In effect, 
this option defines a new top and bottom for the file. During the editing session, all 
subcommands (except for FILE and SAVE) operate only within the range. 




targetl 

is the top of the range. 

A target may be specified as an absolute Hne number, a relative displacement 
from the current hne, a hne name, or a string expression. For more information 
on targets, refer to the LOCATE subcommand in this book and to the 
publication VM/SP System Product Editor User's Guide. 

tar get 2 

is the bottom of the range. 



Initial Setting 
Usage Notes 



RANGE 1 n where n is equal to the size of the file. 



1. After the range is defined, the TOP subcommand moves the hne pointer to the 
line that precedes targetl (to allow insertion at the top of the range). Targetl 
becomes the equivalent of the first line in the file. Top of Range becomes the 
equivalent of the Top of File line. The BOTTOM subcommand moves the line 
pointer to target2. Target2 becomes the equivalent of the last hne in the file. 
End of Range becomes the equivalent of the End of File line. 

2. If the SET RANGE option is entered while the line pointer is outside the limits 
being defined, the current hne becomes the first line of the new range. 

3. FILE and SAVE subcommands write the entire file to disk or directory. No 
other subcommands have access to data outside the range. 

4. The following subcommand resets the range to the physical top and bottom of 
the file: 

set fange -* * 

In order to set a range outside the limits of the current range, you must specify 
targetl and target2 as absolute line numbers. An alternate method is to issue: 

set range :1 * 

(See Appendix B, "Effects of Selective Line Editing Subcommands" on 
page 405 for information about SET RANGE and the SCOPE setting.) 

5. SET RANGE cannot be issued when prefix subcommands or macros are 
pending and it cannot be issued from a prefix macro. 
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SET RANGE 



Messages 



520E Invalid operand: operand [RC = 5] 

528E Invalid range: target2 (line ««) precedes target 1 (line n«) [RC = 5] 

545E Missing operand(s) [RC = 5] 

546E Target not found [RC = 2] 

560E Not enough space for serialization between TRUNC and LRECL 

588E Prefix subcommand waiting... [RC = 8] 



Return Codes 



Normal 

2 Target not found 

5 Missing or invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 

8 Prefix subcommand or macro waiting 
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SET RECFM 



Format 



Operands 



Initial Setting 
Usage Note 
Messages 



Return Codes 



Use the RECFM option to define the record format for the file. 



[set] 


RECFm 


F 
V 
FP 
VP 



specifies that the record format is fixed. 



specifies that the record format is variable. 



FP 



specifies that the record format is fixed packed. 



VP 



specifies that the record format is variable packed. 



Based on the file type. See Appendix A, "File Type Defaults" on page 403. 



When the record format is FP or VP, a SET PACK ON is automatically executed. 



5 1 5E RECFM must be F, V, FP, or VP [RC = 5] 

5 1 6E LRECL too large for V-format file [RC = 4] 

520E InvaUd operand: operand [RC = 5] 

545E Missing operand(s) [RC = 5] 



Normal 

4 Lrecl must be lower than 65536 for recfm V 

5 Missing or invaUd operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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SET REMOTE 



Format 



Operands 



Initial Setting 
Usage Note 
Messages 

Return Codes 



Use the REMOTE option to control the way XEDIT and CMS handle the display 
in terms of data transmission. 




ON 



specifies that XEDIT is to compress the screen by removing nulls and combining 
data when five or more of the same characters occur consecutively in a data 
stream. This minimizes the amount of data transmitted and shortens the buffer, 
thus speeding transmission. 



OFF 



specifies that XEDIT is not to compress the screen. Data will be transmitted 
with no minimization. 



Defined by the CMS setting. 



Changing the editor REMOTE setting also changes the CMS REMOTE setting. 



520E Invalid operand: operand [RC = 5] 
545E Missing operand(s) [RC = 5] 



Normal 

5 Missing or invahd operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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SET RESERVED 



Use the RESERVED option to reserve a specified line on the screen, thereby 
preventing the editor from using that hne. The hne can be used for displaying blank 
or specified information with or without the following features: 

• Color 

• Extended highhghting 

• Programmed symbol set 

• Highlighting. 

The RESERVED option can also be used to give a reserved Une back to the editor. 
This option is designed to be issued from a macro. 



Format 



[set] 



RESERved M [ + n \.n] [color] [exthi] [PSs] High [text] 
[+ \-]n Nohigh 

Off 



Operands 



M[ + n\'n\ 

specifies the hne which is to be the reserved Une. M stands for "middle of the 
screen" (rounded up for odd sized screens). M may be combined with a 
constant positive or negative integer to mean n lines below the middle of the 
screen (M + n), or n lines above the middle of the screen (M — n). For example, 
RESERVED M means the "middle of the screen," and RESERVED M + 3 
means "three hues below the middle of the screen." 



l±|-l« 



specifies the Une which is to be the reserved Une. n or +n (+ is impUcit) 
specifies that the reserved line is displayed n lines from the top of the screen; — n 
specifies that the reserved Une is displayed n lines from the bottom of the screen. 
For example, RESERVED — 3 means that the reserved Une is three Unes from 
the bottom of the screen. 



color 






color can be any 


one 


of the following: 


Blue 




Turquoise 


Red 




Yellow 


Pink 




White 


Green 




Default. 



If you omit color, the default is DEFAULT (default base color). 



exthi 



extended highlighting can be any one of the following: 

BLInk 

REVvideo (reverse video) 

Underline 

NONe. 
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PSs 



If you omit exthi, the default is NONE (no extended highlighting). 

specifies the character set to be used. PSO indicates that the default character set 
will be used. PSs can be any of the following: 



PSG 


PSD 


PSA 


PSE 


PSB 


PSF 


PSC. 





High 

indicates that the data in the reserved line is to be highlighted. 

Nohigh 

indicates that the data in the reserved line is not to be highlighted (normal 
intensity). 



text 



specifies the information that is to be displayed in the reserved line. 



Off 



Initial Setting 



Usage Note 



indicates that a line reserved previously is to be returned for use by the editor. 



No reserved lines are defined. 



The QUERY RESERVED subcommand may be used to display the line numbers of 
reserved lines. 



Notes for Macro Writers 

1 . The EXTRACT/RESERVED/ subcommand returns line numbers of reserved 
lines. The EXTRACT/RESERVED */ subcommand returns information about 
reserved lines. 

2. Reserved lines are associated with the file being edited when they are defined. 
They are displayed only when that file is being displayed. 

3. SET RESERVED +n and SET RESERVED -n are considered to be two 
separate hnes, even when they point to the same line on the screen. 

For example, assume you have a 43 -line screen and issue the subcommands SET 
RESERVED 21 and SET RESERVED -4. Two different Hnes are reserved on 
this screen: line 21 and line 40. However, if the screen size changes to a 24-Hne 
screen, both reserved lines will fall on the same Une. In this case, the editor 
keeps both definitions but displays only the last one defined. 

When turning a reserved line off, you must specify the line the same way you 
defined it. 

4. If you reduce the logical screen size (for example, by splitting the screen), only 
those reserved lines that fall within the smaller screen size are displayed. The 
definition of hnes that do not fit on the screen are kept, even though they are 
not displayed. 

5. A SET RESERVED subcommand issued for the first hne of the command Une 
will be ignored, unless SET CMDLINE OFF has been issued. This prevents you 
from accidentally losing the command line. A reserved line can be set on the 
second line of the command line if CMDLINE ON. 
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6. For information on defining various attributes for fields within a reserved line, 
see the SET CTLCHAR subcommand. 

7. The SET RESERVED subcommand accepts the color, extended highlighting, 
and programmed symbol set operands whether or not the device has the ability 
to use those attributes. However, the action taken depends upon the device. 
For example, HIGH and NOHIGH are ignored on a 3279 display (unless the 
color was DEFAULT), color is ignored on a 3278 display, and color, extended 
highUghting, and character set are ignored on a 3277 display. Also, QUERY 
and EXTRACT return all the settings, even those that may be ignored on any 
given terminal. 

8. On 3270 terminals equipped with the Programmed Symbol (PS) feature you can 
specify alternate character sets to be used on your terminal. The characters in 
these sets use different symbols, such as a different style or font, than the default 
character set. 

New character sets are loaded using the Graphic Data Display Manager 
(GDDM) program product (5748-XXH) or an application that loads 
programmed symbol sets. Character sets should be loaded before invoking 
XEDIT. If a new set is loaded, it will not be recognized and the last character 
set loaded prior to invoking the editor will be displayed. Likewise, if you drop a 
programmed symbol set, the editor is not aware that the set is no longer 
available and attempts to use that set. This may cause I/O errors when the 
display is written (resulting in SET TERMINAL TYPEWRITER). To avoid 
problems, do not load or delete program symbol sets when in the XEDIT 
environment. 

9. A SET RESERVED subcommand issued for the first line of the message hne 
will be ignored unless SET MSGLINE OVERLAY has been issued. 

10. If you use SET RESERVED for screen row one, the reserved line will be offset 
by one column; the row will begin in column two instead of column one. 



Response 



The information specified in the text operand, if any, appears on the specified 
reserved line. 



Messages 



520E Invalid operand: operand [RC = 5] 

521 E Invalid line number [RC = 5] 

526E Option option valid in display mode only [RC ■■ 

533E Line nn is not reserved [RC = 4] 

545E Missing operand(s) [RC = 5] 



3] 



Return Codes 



Normal 

3 Operand is valid only for display terminal 

4 Line is not reserved 

5 Missing or invaUd operand or number 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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SET SCALE 



Format 



Operands 



Use the SCALE option to display a scale line under the current line (the default) or 
on a specified line, to assist you in editing. 




ON 

displays the scale on the screen. 

MI + n\-n] 

specifies the hne in which the scale hne is displayed. M stands for "middle of 
the screen" (rounded up for odd sized screens). M may be combined with a 
constant positive or negative integer to mean n lines below the middle of the 
screen (M + n), or n Hnes above the middle of the screen (M — n). For example, 
SCALE ON M means the "middle of the screen," and SCALE ON M + 3 means 
"three lines below the middle of the screen." 

[±\'\n 

specifies the line in which the scale line is displayed, n or +n (+ is implicit) 
specifies that the scale line is displayed n lines from the top of the screen; — n 
specifies that the scale line is displayed n lines from the bottom of the screen. 
For example, SCALE ON - 3 displays the scale hne three hnes from the bottom 
of the screen. 



OFF 



removes the scale from the screen. 



Initial Setting 
Usage Notes 



SCALE ON M+1. 



1. The scale looks like this: 



<...+. 



.3.>..+....4T...+, 



.column pointer 
left zone 



.truncation column 
right zone 



2. If a Une occupies more than one screen Une and the scale is on an adjacent hne, 
the scale is not displayed for that line. The scale is redisplayed when the line 
pointer moves to a file Une that occupies only one screen line. 
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Messages 



520E Invalid operand: operand [RC = 5] 

52 1 E Invalid line number [RC = 5] 

526E Option option valid in display mode only [RC = 3] 

545E Missing operand(s) [RC = 5] 



Return Codes 



Normal 

3 Operand is valid only for display terminal 

5 Missing or invalid operand or number 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the rint 
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SET SCOPE 



Format 



Operands 



Use the SCOPE option to specify the set of lines on which the editor operates. The 
operand (ALL or DISPLAY) indicates if the collection includes all lines in the file or 
only the lines displayed. For an illustration of how SET SCOPE can be used 
effectively in combination with the other selective hne editing subcommands (SET 
DISPLAY, SET SHADOW, and SET SELECT), see SET SELECT in this 
pubUcation. 




Display 

indicates that the editor acts only on those lines currently in the display range as 
specified by SET DISPLAY. It performs as if the lines which are outside the 
display range are not part of the file. 



All 



indicates that the editor acts on the entire file. 



Initial Setting 
Usage Notes 



SCOPE DISPLAY 



1 . Target searches are performed only on lines within the current scope. If SCOPE 
DISPLAY has been set, the target search only considers and looks at displayed 
lines. This is true for all types of targets: absolute line numbers, a relative 
displacement from the current line, a line name, a simple string expression, or a 
complex string expression. Line movement by use of targets is done as if lines 
outside the scope had been removed. For example, NEXT or + 1 may go from 
line 20 to line 40 if lines 21 to 39 are outside the display range. 

2. If SCOPE DISPLAY is set and the current Hne's selection level is not within the 
SET DISPLAY nl n2 values, the editor forces the current line out of the 
display, causing the first Une following it in the scope to be the new current line. 
This can occur if: 

a. You issue SET SELECT changing the current line's selection level 

b. You issue SET DISPLAY, changing lines that are displayed 

c. You issue SET SCOPE DISPLAY and the previous setting was SCOPE 
ALL. 

3. If SCOPE ALL is set, the current Une is always included in the display. Its 
selection level is not modified, but its display status is forced as long as it 
remains the current line. 

4. While SCOPE ALL is set, the editor acts on the entire file, even that portion of 
the file that is not displayed. Therefore, a Hne which is not displayed may be 
changed by the editor. 
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For examples of this and other selective line editing subcommands, you can 
examine the following IBM-supphed macros: ALL (whose file ID is ALL 
XEDIT), which restricts editing to a particular set of lines, and the X prefix 
macro (whose file ID is PREFIXX XEDIT), which excludes lines from the 
display. See also Appendix B, "Effects of Selective Line Editing 
Subcommands" on page 405. 

SORT, SET RANGE, and ALL work outside the scope. 

If SCOPE DISPLAY is set and the last Une of the file is a shadow line, with the 
current line being the end of file line, entering input mode will cause the last line 
of the shadow line group to be displayed as the current line. In this case, a Une 
that was outside the scope can be changed. 



Messages 



Return Codes 



520E InvaUd operand: operand [RC = 5] 
545E Missing operand(s) [RC = 5] 



Normal 

5 Missing or invaUd operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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SET SCREEN 



Format 



Use the SCREEN option to divide the virtual screen into a specified number of 
logical screens so that you may edit multiple files or multiple views of the same file. 
Each logical screen becomes, in effect, an independent terminal with its own file 
identification Une, command line, and message Une. 




SCReen n \ Horizontal | Vertical] 

Size sl[s2[s3...[s«]]] 
Width wl [w2[w 3 ...[wn]]] 
Define sllswl shlsvl [sl2 sw2sh2sv2], 



Operands 



specifies the number of logical screens that the virtual screen is to be divided 
into. If only n is specified, Horizontal is assumed. 

Horizontal 

specifies that the logical screens are arranged horizontally, that is, one on top of 
the other, n must be specified such that all horizontal screens are at least five 
lines long. 

Vertical 

specifies that the logical screens are arranged vertically, that is, next to each 
other, from left to right, n must be specified such that all vertical screens are at 
least 20 columns wide. 

Size sl[s2[s3...[sn]]] 

specifies that the screens are created horizontally, where "sn" is the number of 
lines in each logical screen. Any number of screens can be created, provided 
each is at least five Unes long (that is, "sn" cannot be less than five). 

Width wl[w2[w3...[wn]]] 

specifies that the screens are created vertically, where "wn" is the number of 
columns in each screen. Any number of screens can be created, provided each is 
at least 20 columns wide (that is, "wn" cannot be less than 20). 

Define sll swl shl svl [sl2 sw2 sh2 sv2J... 

indicates that each screen is created according to the layout specified, where: 

• "sin" is the number of lines in the logical screen. 

• "swn" is the number of columns in the logical screen. 

• "shn" is the line number of the upper left corner of the logical screen on the 
virtual screen. 

• "svn" is the column number of the upper left corner of the logical screen on 
the virtual screen. 

The maximum number of screens that can be created is 16, provided "sin" is not 
less than 5 and "swn" is not less than 20. 
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Initial Setting 
Usage Notes 



SCREEN SIZE si, where si is the number of rows in the virtual screen. 



1 . When multiple files are being edited, the files are arranged in a "ring" in virtual 
storage (see the XEDIT subcommand for more information on the ring of files). 
If a SET SCREEN subcommand increases the number of logical screens, the 
additional screens are immediately filled with files selected from the ring of files. 

The file that immediately follows (in the ring) the last file that is displayed on 
the screen fills up the first empty logical screen, and so forth. 

Any files that were already displayed before the SET SCREEN subcommand 
was executed remain on the screen and keep their relative positions on the 
virtual screen. 

However, if the number of logical screens is decreased due to a SET SCREEN 
subcommand, files will still be displayed, beginning with the file in the ring that 
issued the SET SCREEN subcommand, as long as logical screens are available. 
Those files for which logical screens are no longer available are removed from 
the display. 

2. When vertical screens are defined (using SET SCREEN WIDTH or SET 
SCREEN DEFINE), the entire width of the virtual screen must be accounted 
for, that is, the logical screens must occupy the full virtual screen width. 

When defining vertical screens, remember to consider the width of the logical 
screens compared with the Une length of the file(s) being edited. If the file Une 
length exceeds the logical screen width, lines are displayed up to that width, that 
is, they do not "wrap," and changing the SET VERIFY setting will not cause 
them to wrap. 

On vertical screens, messages are broken up into as many lines as needed to 
display the entire message (up to the number of lines specified in the SET 
MSGLINE subcommand). If a message exceeds this number, it is passed to 
CMS and the message is displayed. When full-screen CMS is OFF, press the 
CLEAR key to redisplay the file. When full-screen CMS is ON, the message 
will appear in the CMSOUT window. To see all of the information in the 
virtual screen, you can use the CMS SCROLL command. The screen will be 
cleared automatically when you scroll to the bottom of the virtual screen. An 
alternative way to clear the screen is to issue the CMS DROP WINDOW 
command. If you have deleted the CMSOUT window, you won't see messages 
that are passed to CMS. 

3. The SET SCREEN subcommand retains the CURLINE, SCALE, TABLINE, 
CMDLINE, MSGLINE, and RESERVED locations on the screens, provided 
that these settings fall within the new screen size. Otherwise, the default settings 
are used. 

When CMDLINE ON is in effect and vertical screens are defined, the command 
line is displayed on the bottom line of the screen since lines cannot extend on 
multiple screen lines (see usage note 2). The status area is not displayed. The 
editor remembers this change and returns the CMDLINE to ON if the screen 
definition is subsequently changed to a non- vertical screen(s). 

4. Entering input mode on one screen (issuing the INPUT subcommand without 
any operands), causes subcommands entered on other logical screens to either 1) 
be ignored, if the screen contains a view of the same file, or 2) remain on the 
command Une and not execute until input mode is exited, if the screen contains a 
view of a different file. 
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Responses 



Messages 



Return Codes 



5. For information on the order of processing, please refer to the publication, 
VMjSP System Product Editor User's Guide, Chapter 5. 

6. If more than one logical screen is defined before issuing a "disconnect" from 
XEDIT, the screen setting will be redefined to one screen when the session is 
reconnected on a different sized terminal. This would be the equivalent of 
issuing a SET SCREEN 1 after reconnecting. 

7. If the window being used is changed through the use of the XEDIT window 
option while there are multiple logical screens, the editing session will continue 
with only one logical screen (with the same number of rows and columns as the 
virtual screen). 



In horizontal screens, the status area of each logical screen contains the number of 
files being edited. 

The screens are displayed as specified. 



520E InvaUd operand: operand [RC = 5] 

526E Option option vahd in display mode only [RC = 3] 

534E Too many logical screens defined [RC = 4] 

536E Logical screens exceed virtual screen size [RC= 1] 

537E Each logical screen must contain at least 5 lines and 20 colxmms [RC = 4] 

543E Invahd number: number [RC = 5] 

545E Missing operand(s) [RC = 5] 

566E Logical screen {sll,swl,shl,svl) is outside the virtual screen [RC = 5] 

567E Logical screens {sll,swl,shl,svl) and {sl2 ,sw2 ,sh2 ,sv2) overlap each other 

[RC = 5] 

697E The logical screens must cover the full virtual screen width [RC = 5] 



Normal 

1 The total number of lines or columns for the multiple logical screens exceeds 
the virtual screen size 

3 Operand is only vahd for display terminal 

4 Each logical screen must contain at least 5 hnes and 20 columns, or too many 
logical screens defined 

5 Missing or invalid operand or number 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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Examples 



set screen 2 

splits the screen horizontally into two logical screens. 

set screen 2 V 

splits the screen vertically into two logical screens. 

set screen size 14 10 

splits the screen horizontally into two logical screens, the first of which is 14 lines 
long and the second of which is 10 Hnes long. 

set screen width 25 25 30 

creates three logical vertical screens, 25, 25, and 30 columns wide, respectively. 

set scr def 16 40 1 1 16 40 1 41 8 80 17 1 

results in the following screen layout on a 24 x 80 virtual screen. 

(1.1) (1,41) 

************************************************* 

* * * 

* * * 

* * * 

* 16 X 40 * 16 X 40 * 

* * * 

* * * 

* * * 

M 7 1 \ ************************************************* 



* 8 X 80 * 

* * 

* * 
************************************************* 
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SET SELECT 



Format 



Operands 



Use the SELECT option to designate a "selection level" for specified lines. A 
selection level is a positive value assigned to a line in a file. Various lines in a file 
may be grouped logically by assigning them the same selection level. This 
subcommand can be used effectively with the SET DISPLAY, SET SHADOW, and 
SET SCOPE subcommands. 




is the selection level for the lines specified, "n" is a number and specified by 
itself without a + or — assigns an absolute "n" value as the selection level for 
the hnes specified. 



initial Setting 
Usage Notes 



adds( + ) or subtracts( — ) "n" from the current selection level(s) of the lines 
specified. For example, if you used "SET SELECT 8 3" the selection level "8" 
would be assigned to three lines in the file. To assign a level of "6" to the three 
Unes you have just assigned a selection level of "8" to, use "SET SELECT —2 
3" or "SET SELECT 6 3." Likewise, to assign a level of "10" to the three Unes 
you have just assigned a selection level of "8" to you could either use "SET 
SELECT +2 3" or "SET SELECT 10 3." 

target 

defines the number of lines to be assigned a selection level. The selection level is 
assigned from the current Une up to, but not including, the specified target line. 
If you enter an asterisk (*), the selection level is assigned to the rest of the file. 
If you omit the target, only the current line's selection level is set. 

A target may be specified as an absolute line number, a relative displacement 
from the current line, a line name, or a string expression. For more information 
on targets, refer to the LOCATE subcommand in this book and to the 
publication VMjSP System Product Editor User's Guide. 



SELECT (for the entire file) 



1 . Selective line editing can be used in a macro to control both the action of the 
editor and the screen display. It consists of four subcommands, SET SELECT, 
SET DISPLAY, SET SCOPE, and SET SHADOW, which work together in the 
following manner. You can use SET SELECT to assign a "selection level," or 
value, to one or more lines in a file. Lines can be logically grouped by assigning 
them the same selection level. SET DISPLAY may be used in conjunction with 
SET SELECT to display those hnes which have the same selection level. SET 
SCOPE defines the set of Hnes that the editor can act upon. SCOPE DISPLAY 
is the initial setting and, as such, restricts editor action to only those Unes that 
are defined by SET DISPLAY. By default, SET SHADOW displays a notice 
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indicating how many lines are not being displayed in the physical position of the 
excluded lines in the file. If SET SHADOW is "OFF," only those lines defined 
by SET DISPLAY will appear on the screen, with no shadow Unes to indicate 
where lines are not being displayed. 

2. For examples of this and other selective line editing subcommands, you can 
examine the following IBM-suppUed macros: ALL (whose file ID is ALL 
XEDIT), which restricts editing to a particular set of Unes, and the X prefix 
macro (whose file ID is PREFIXX XEDIT), which excludes lines from the 
display. 

3. If you specify -n, which would cause the selection level of the line to be 
negative, the selection level is set to zero instead. 

4. TOF and EOF will always be set to the nl value of SET DISPLAY, even 
though you cannot assign a selection level to either of them. 

5. For more information on selective Une editing, see Appendix B, "Effects of 
Selective Line Editing Subcommands" on page 405. 



Responses 



If you specify that SET SELECT is to occur on multiple lines and it does occur, the 
current line pointer will be: 

a. Unchanged if SET STAY ON has been issued 

b. Moved to the last line assigned a selection level, if SET STAY OFF is in 
effect (the default). 

If SCOPE DISPLAY is set and the current line's selection level is not within the 
SET DISPLAY nl n2 values, the editor forces the current line out of the display, 
causing the first line following it in the scope to be the new current line. This can 
occur if: 

a. You issue SET SELECT changing the current Une's selection level 

b. You issue SET DISPLAY, changing lines that are displayed 

c. You issue SET SCOPE DISPLAY and the previous setting was SCOPE 
ALL. 



Messages 



Return Codes 



520E InvaHd operand: operand [RC = 5] 

545E Missing operand(s) [RC = 5] 

546E Target not found [RC = 2] 

585E No line(s) changed [RC = 4] 



Normal 

1 TOF or EOF reached 

2 Target not found 

4 No change occurred 

5 Missing or invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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Example 



Figure 14 demonstrates the usage of the selective line editing subcommands: SET 
SELECT, SET SHADOW, SET DISPLAY, AND SET SCOPE. 



Elbert had a record collection for which he established a "names" file. He used the 
following organization scheme: 

NICK for opera 

C for classical 

COMPOSER Name of Composer 

NAME Name of Composition 

ADDRESS C or 0, depending on type, 

followed by the assigned number 
on the record jacket. 

Elbert wanted to be able to list all the records in his collection by type. Using the 
macro below, Elbert located all the Hnes in the file which contained :nick.O and 
assigned a selection level of 1 to them. He also located all lines in the file which 
contained :nick.C, assigning a selection level of 2 to them. 



/**** Xedit macro to set se1 

'COMMAND TOP' 

'COMMAND SET WRAP OFF' 

'COMMAND SET MSGMODE OFF' 

'COMMAND SET CASE M r 

'COMMAND LOCATE /:NICK.O/' 

Do until re -'= 

'COMMAND SET SELECT 1 1' 
'COMMAND LOCATE /:NICK.O/' 
End 

'COMMAND TOP' 

'COMMAND LOCATE /rNICK.C/' 

Do until re -'= 

'COMMAND SET SELECT 2 1' 
'COMMAND LOCATE /rNICK.C/' 
End 

'COMMAND TOP' 

'COMMAND SET MSGMODE ON' 

Exit 



/* 
/* 
/* 



ection levels for Elbert's Records 

/* Start at the Top of the file 

Do not wrap on Locate command! 

Suppress 'TARGET NOT FOUND' msg 

Ignore case on searches 
/* Look for first rnick.O 
/* Loop until LOCATE fails (re > 0) 

Set selection level 1 

Now, find the next one... 

End of loop 

Start at top again 

Now look for rnick.C 

Loop until LOCATE fails (re>0) 

Set selection level 

Find next occurrence 

End of Loop 

Go back to the top 

Now we want messages again 

Exit the macro 



V 



/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 



V 

*/ 

V 
V 
V 
V 
V 
V 
V 
V 
V 
V 
V 
V 
V 
V 
V 



Note: Please note that after the macro executes, you will be at the top of your file. 
For purposes of allowing you to see more of the file, however, we have moved down 
in the file to make line 9 the current line. 

Figure 14 (Part 1 of 7). SET SELECT, SET SHADOW, SET DISPLAY, and SET 
SCOPE 
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All nick.O or nick.C lines in the file have now been assigned a selection level. They 
appear as shadow lines, because the initial setting of SET DISPLAY is and any 
lines in the file not assigned a selection level of 1 or 2 will have a selection level of 0. 
In order to look at all the nick.O compositions, Elbert issued the command, SET 
DISPLAY 1 1 as shown below. 



ELBERT NAMES A0 V 255 Trunc=255 Size=17 Line=9 Col=l Alt=0 



* * * Top of File * * * 

-- 1 line(s) not displayed 



:addr.01 



1 line(s) not displayed 

:addr.Cl 



■ 1 line(s) not displayed --- 

:addr.C4 

1 + 2 + 3 + 4 + 5 + 6 + . 



1 line(s) not displayed 



:addr.C3 



1 line(s) not displayed 

:addr.02 



== 1 line(s) not displayed 

:addr.C2 
== * * * End of File * * * 
=> set display 1 1 



X E D I T 1 File 



Figure 14 (Part 2 of 7). SET SELECT, SET SHADOW, SET DISPLAY, and SET 
SCOPE 
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The resulting display listed only those lines in the file with a selection level of 1 or 
those assigned to nick.O hnes in the file. Elbert then set the display to list all lines 
assigned a selection level of 2, by issuing the subcommand below. 

ELBERT NAMES AO V 255 Trunc=255 Size=17 Line=13 Col=l Alt=G 



* * * Top of File * * * 

rnick.O : Composer. Puccini :name.LaBoheme 



11 line(s) not displayed -- 

:nick.O : Composer. Verdi :name.Aida 

I...+....1....+....2....+....3....+....4....+....5. 

4 line(s) not displayed --- 

* * * End of File * * * 



====> set display 2 2 



X E D I T 1 File 



Figure 14 (Part 3 of 7). SET SELECT, SET SHADOW, SET DISPLAY, and SET 
SCOPE 
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The display now listed only Elbert's classical selections (nick.C). To list both types 
of selections, Elbert issued the command, SET DISPLAY 1 2. That displayed all 
Unes in the file with either a selection level of 1 or 2. 



ELBERT NAMES A0 V 255 Trunc=255 Size=17 Line=16 Col=l Alt=0 



:==== * * * jqp Qf Pile * * * 

:==== 3 line(s) not displayed 

===== rnick.C : Composer. Grieg: name. Peer Gynt Suites 

===== __ 2 line{s) not displayed 

===== :nick.C : Composer. Ravel : name. Piano Concerto in G Major 

===== 2 line(s) not displayed — 

===== :nick.C : Composer. Offenbach: name. Les Bavards 

===== - -- 5 line(s) not displayed 

===== :nick.C : Composer. Mozart: name. Eine kleine Nachtmusik 

I... + 1 + 2 + 3 + 4 + 5 + 6.. 

===== _ __ 1 line(s) not displayed - 



End of File * * * 



====> set display 1 2 



X E D I T 1 File 



Figure 14 (Part 4 of 7). SET SELECT, SET SHADOW, SET DISPLAY, and SET 
SCOPE 
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Annoyed by the appearance of shadow Hnes in the screen display, Elbert issued the 
subcommand, SET SHADOW OFF to eliminate shadow lines from the screen 
display. 

ELBERT NAMES AO V 255 Trunc=255 Size=17 Line=16 Col=l Alt=G 



2 line(s) not displayed 

inick.C : Composer. Grieg: name. Peer Gynt Suites 



===== 2 1ine(s) not displayed 

===== inick.C :Composer. Ravel :name. Piano Concerto in G Major 



2 line(s) not displayed 

:nick.C : Composer. Offenbach: name. Les Bavards 



:== 2 line(s) not displayed 

=== :nick.O : Composer. Verdi : name. Ai da 

:== 2 line{s) not displayed 

=== :nick.C :Composer.Mozart:name.Eine kleine Nachtmusik 



1 line(s) not displayed 



End of File 





























































hadow off 




























X 























X E D I T 1 File 



The result is a listing of all lines in the file which have been assigned selection levels. 
Please note the absence of shadow hnes. 



ELBERT NAMES AO V 255 Trunc=255 Size=17 Line=16 Col=l Alt=0 



* * * Top of File * * * 

:nick.O : Composer. Puccini rname.LaBoheme 

:nick.C :Composer.Grieg:name.Peer Gynt Suites 

:nick.C :Composer. Ravel :name. Piano Concerto in G Major 

:nick.C :Composer.Offenbach:name.Les Bavards 

:nick.O :Composer. Verdi :name.Aida 

:nick.C :Composer.Mozdrt:name.Eine kleine Nachtmusik 

I...+....1....+....2....+....3....+....4....+....5....+....5.. 

* * * End of File * * * 



====> set scope all 



X E D I T 1 File 



Figure 14 (Part 5 of 7). SET SELECT, SET SHADOW, SET DISPLAY, and SET 
SCOPE 
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Elbert decided to add some country and western records to his collection. In order 
to avoid confusion between his classical records and his country records, he changed 
.C to .X. In the previous screen, he issued SET SCOPE ALL to expand editor 
control to include the entire file. This was necessary so that both the lines listing 
composers' names and those listing record addresses would be changed. 

ELBERT NAMES AO V 255 Trunc=255 Size=17 Line=16 Col=l Alt=0 



* * * Top of File * * * 

rnick.O .-Composer. Puccini : name. La Bo heme 

:nick.C : Composer. Grieg: name. Peer Gynt Suites 

:nick.C : Composer. Ravel : name, Piano Concerto in 6 Major 

rnick.C : Composer. Offenbach: name. Les Bavards 

:nick.O :Composer. Verdi :name.Aida 

:nick.C :Composer.Mozart:name.Eine kleine Nachtmusik 

I...+....1....+....2....+....3....+....4....+....5....+....6.. 

* * * End of File * * * 



=> :1 change/. C/.X/ 



X E I T 1 File 



Figure 14 (Part 6 of 7). SET SELECT, SET SHADOW, SET DISPLAY, and SET 
SCOPE 



Chapter 3. XEDIT Subcommands and Macros 297 



SET SELECT 



In order to display the entire file, Elbert issued SET DISPLAY *. This displayed 
all selection levels of lines, starting with 0. 



ELBERT NAMES AG V 255 Trunc=255 Size=17 Line=18 Co1=l Alt=l 
5171 8 occurences (s) changed on 8 line(s) 



===== * * * jqp Q-f piig * * * 

===== tnick.O : Composer. Puce i ni : name. LaBoheme 

===== :nick.X : Composer. Grieg: name. Peer Gynt Suites 

===== :nick.X : Composer. Ra vel : name. Piano Concerto in G Major 

===== rnick.X : Composer. Offenbach: name. Les Bavards 

===== :nick.O :Composer. Verdi rname.Aida 

===== :nick.X :Composer.Mozart:name.Eine kleine Nachtmusik 

===== * * * End of File * * * 

I...+....1....+....2....+....3....+....4....+....5....+....6....+....7. 



=> set display G * 



X E D I T 1 File 



Following the changes, Elbert's file looks like the display below. Please note that we 
have changed the current line, without issuing the subcommand here, so that you 
may see more of the file. 



ELBERT NAMES AG V 255 Trunc=255 Size=17 Line=9 Col=l Alt=l 

:==== * * * jop of File * * * 

===== :nick.O : Composer. Pucci ni : name. LaBoheme 

===== :addr.01 

===== :nick.X : Composer. Grieg: name. Peer Gynt Suites 
===== :addr.Xl 

===== :nick.X :Composer. Ravel :name. Piano Concerto in G Major 
===== :addr.X4 

I...+....1....+....2....+....3....+....4....+....5....+....6....+....7.. 
===== :nick.X : Composer. Offenbach: name. Les Bavards 
===== :addr.X3 

===== :nick.O : Composer. Verdi : name. Ai da 
===== :addr.02 

===== :nick.X :Composer.Mozart:name.Eine kleine Nachtmusik 

===== :addr.X2 

===== * * * End of File * * * 

X E D I T 1 File 



Figure 14 (Part 7 of 7). SET SELECT, SET SHADOW, SET DISPLAY, and SET 
SCOPE 
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SET SERIAL 



SET SERIAL 



Format 



Use the SERIAL option to control file serialization. 



[set] 


SERial ON 
ALL 

string 

OFF 


incrno 
10 

incrno 
1000 

incrno 
10 


startno 
10 

startno 
1000 

startno 
10 


: 





Operands 



ON 



adds a serial identification in the last eight columns of each file line. The serial 
identification consists of the first three letters of the file name plus five digits, 
where startno is the starting value and incrno is the increment. 

ALL 

adds a serial identification in the last eight columns of each file line. The serial 
identification consists of eight digits, where startno is the starting value and 
incrno is the increment. 

string 

adds a serial identification in the last eight columns of each file Une. The serial 
identification consists of the characters specified in string, and, if string contains 
fewer than eight characters, a number, where startno is the starting value and 
incrno is the increment. If string contains more than eight characters, it is 
truncated to eight characters. 



OFF 



specifies that the serial identification area is not to be updated the next time the 
file is written to disk or directory. 



Initial Setting 



Based on file type. See Appendix A, "File Type Defaults" on page 403. 



Chapter 3. XEDIT Subcommands and Macros 299 



SET SERIAL 



Linage Notes 



1. Only files with a fixed record format can be serialized. Also, the room between 
TRUNC and LRECL must be at least eight characters in order to seriaUze the 
file (if not, message 560E is displayed). 

2. The seriaHzation takes place only when a FILE or SAVE subcommand is issued. 

3. To remove the serial identification from a file whose logical record length is 80, 
you can use the following sequence of subcommands: 

set trunc 80 
set zone 1 80 
set serial off 
top 
next 

clocate :73 
cdelete 8 
repeat * 



Messages 



Return Codes 



520E InvaUd operand: operand [RC = 5] 

543E Invalid number: number [RC = 5] 

545E Missing operand(s) [RC = 5] 

558E Wrong file format for serialization [RC = 5] 

560E Not enough space for serialization between TRUNC and LRECL 



Normal 

5 Missing or invalid operand or number, or wrong file format 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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SET SHADOW 



SET SHADOW 



Format 



Operands 



Use the SHADOW option to display a notice (called a shadow line) that indicates 
how many lines have been excluded from the display. The shadow line appears in 
the physical position in the file of the excluded lines(s). For an illustration of how 
SET SHADOW can be used effectively in combination with the other selective hne 
editing subcommands (SET SELECT, SET SCOPE, and SET DISPLAY), see SET 
SELECT in this pubUcation. 




ON 



displays a shadow line which cites the number of Unes omitted in the display. 
Each shadow line is in the physical position of the omitted line or block of lines. 



OFF 



causes lines not displayed by virtue of the SET DISPLAY subcommand to 
disappear totally from the screen, thus allowing no visual representation of 
them. 



initial Setting 
Usage Notes 



SHADOW ON 



1. For examples of this and other selective line editing subcommands, you can 
examine the following IBM-suppUed macros: ALL, (whose file ID is ALL 
XEDIT), which restricts editing to a particular set of lines, and the X prefix 
macro (whose file ID is PREFIXX XEDIT), which excludes Unes from the 
display. See also Appendix B, "Effects of Selective Line Editing 
Subcommands" on page 405. 

2. If a prefix macro is entered on a shadow line, then the line number of the first 
excluded line is passed to the macro as "pline" (the line number on which the 
prefix macro was entered). (Refer to SET PENDING in this pubUcation.) 

3. With SET NUMBER ON, the sequence numbers enable you to determine which 
Unes are excluded from the display. This is especially useful if SHADOW OFF 
has been set. If SHADOW is ON, the sequence number in a shadow line is the 
first Une in a block of excluded Unes. 



l\/lessages 



520E Invalid operand: operand [RC = 5] 
545E Missing operand(s) [RC = 5] 
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SET SHADOW 



Return Codes 

Normal 

5 Missing or invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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SET SIDCODE 



SET SIDCODE 



Format 



Use the SIDCODE option to insert a character string in every line of an update file. 
The string is inserted in the first eight columns of the last 17 columns of the file line 
{Irecl— 16 to lrecl—9). For example, if you have a file with fixed, eighty-character 
lines, the editor inserts the string in columns 64-71. If the string is less than eight 
characters, it is padded on the right with blanks. Any data in the eight columns is 
overlaid. 



[set] 



SIDcode [string] 



Operand 



Initial Setting 



Usage Notes 



IVIessages 
Return Codes 



string 



is the character string (1-8 characters) that is to be inserted in every line of an 
update file. If you omit string, SIDCODE is set to blanks. If string contains 
more than eight characters, it is truncated to eight characters. 



SIDCODE is set to blanks (or as specified in the XEDIT command or the LOAD 
subcommand). 



1 . The string is inserted in every line of an update file when at least one change is 
made to the update file and it is filed (or saved). 

2. Data will not be overlaid in Unes with a character in column Irecl— S. 

3. See also the SIDCODE option of the XEDIT command. 

4. When SIDCODE is set to all blanks (the default setting), columns Irecl— 16 to 
lrecl—9 are left unchanged. 

520E Invalid operand: operand [RC = 5] 



Normal 

5 Invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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SET SPAN 



SET SPAN 



Format 



Use the SPAN option to specify if a character string, which is the subject of a target 
search, must be included in one line in order to be found, or if it may span a 
specified number of lines. 



[set] 


SPAN ON 
OFF 


Blank 
Noblank 


n 
* 


■ 



Operands 



Initial Setting 



ON 



specifies that Unes are concatenated during a search for a character string. 
TraiUng blanks are removed. 

Blank 

specifies that one blank character is inserted between consecutive file lines and 
must be considered when defining the target. This is the standard setup for 
SCRIPT and other text files. Lines are temporarily concatenated for the search, 
separated by one blank. Any trailing blanks are ignored. 

Noblank 

specifies that consecutive file lines are concatenated temporarily but are not 
separated by a blank. 

n 

specifies the number of consecutive file lines that a character string can span. If 
an asterisk (*) is specified the rest of the file is searched. 



OFF 



specifies that a character string must be included within one file line in order to 
match a target. 



SPAN OFF BLANK 2 
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Usage Notes 



Messages 



Return Codes 



SET SPAN 



1 . When consecutive file lines are searched for a string, the search occurs within the 
columns defined in the SET ZONE subcommand. Portions of consecutive lines 
are concatenated for the search, separated or not by blanks (as specified in SET 
SPAN ON BLANK or SET SPAN ON NOBLANK). 

2. In SCRIPT or other text processing files, SET SPAN ON BLANK and SET 
VARBLANK ON can be combined to advantage. 



If the file contains 

left zone 
1 



right zone 

72 



The house 



was near 



on two consecutive lines, the two file lines, when concatenated for the search if SET 
SPAN is ON, would have many blanks (depending on the logical record length) 
between "house" and "was," in addition to the single blank inserted because of SET 
SPAN ON BLANK. However, the SET VARBLANK ON would still permit the 
target /house was/ to match the text. 

On the other hand, a programmer editing an object deck produced by a compiler 
(file type TEXT, zones 1 72) or a PL/I source program (file type PLI, zones 2 72) 
should use SET SPAN ON NOBLANK, since no implicit blanks are assumed to 
separate lines. 



For example: 

left zone 
1 



right zone 

72 



X=' THE LIT 



TLE HOUSE'; 

The target /THE LITTLE HOUSE/ will be found. 



520E Invalid operand: operand [RC = 5] 
543E Invalid number: number [RC = 5] 
545E Missing operand(s) [RC = 5] 



Normal 

5 Missing or invalid operand or number 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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SET SPILL 



SET SPILL 



Format 



Operands 



Initial Setting 
Usage Notes 



Use the SPILL option to specify if data is spilled onto new lines or lines are 
truncated following these subcommmands: CHANGE, CINSERT, COVERLAY, 
CREPLACE, EXPAND, GET, INPUT, MERGE, OVERLAY, REPLACE, SHIFT, 
(and macros that use these subcommands internally, including CAPPEND, JOIN 
andPRFSHIFT(>, > >)). 




ON 



specifies that characters pushed beyond the truncation column are inserted in the 
file as one or more new lines, starting with the first character that would have 
gone beyond the truncation column. 

OFF 

specifies that any characters pushed beyond the truncation column are lost. 

WORD 

specifies that characters pushed beyond the truncation column are used to create 
one or more new hues, as necessary. However, a word is not split between Unes 
if possible. It is moved, or "spilled," in its entirety. Thus, the first character of 
each new hne is the first non-blank character following the last blank within the 
truncation setting (see SET TRUNC) on the affected line. 



Based on file type. See Appendix A, "File Type Defaults" on page 403. 

1. SET SPILL affects only SHIFT issued with the RIGHT operand; any characters 
shifted past the truncation column spill onto new lines. SET SPILL has no 
effect on SHIFT LEFT; data shifted to the left past the zonel column is lost. 

2. For GET, the LRECL is used for the truncation column instead of the TRUNC 
setting. 

For JOIN, SPILL OFF functions Uke SPILL ON. JOIN does not truncate data. 

Recovered lines (see RECOVER) are not spilled. 



New lines which are inserted because of the SPILL setting will always be 
inserted starting at column 1, regardless of whether SET IMAGE is ON or OFF. 



6. When SET VERIFY is ON and a line is changed by a subcommand and spilled 
as a result, the last line inserted due to SET SPILL will be displayed. 
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SET SPILL 



Messages 



Return Codes 



Examples 



520E Invalid operand: operand [RC = 5] 
545E Missing operand(s) [RC = 5] 



Normal 

5 Missing or invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 



With SET SPILL WORD: 

===== Now is the time for all good men to come to the aid of their party. 

====> c/good/good, courageous, stout-hearted/ 
results in: 

===== Now is the time for all good, courageous, stout-hearted men to come to 

I...+ 1 + 2 + 3 + 4 + 5 + 6 + 7.T. 

===== the aid of their party. 

With SET SPILL ON, the same CHANGE subcommand results in: 

===== Now is the time for all good, courageous, stout-hearted men to come to t 

I...+ 1 + 2 + 3 + 4 + 5.... +....6 + 7.T, 

===== he aid of their party. 
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SET STAY 



SET STAY 



Format 



Operands 



Use the STAY option to specify whether or not the line pointer is to move when a 
string that is the object of a LOCATE target search, FIND, FINDUP, NFIND, or 
NFINDUP is not found. Also, use the STAY option to specify whether or not the 
line pointer is to move when a string that is the object of the target search for 
CHANGE, COUNT, COMPRESS, EXPAND, LOWERCAS, SET SELECT, 
SHIFT, or UPPERCAS is found. 




ON 



specifies that the line pointer is not to move. 



OFF 



specifies that the line pointer moves. 



Initial Setting 
Usage Notes 



STAY OFF 



SET STAY applies to LOCATE target searches and FIND family searches 
issued to the end of file (or end of range). With SET STAY OFF, the null End 
of File (or End of Range) line will become the new current line if a search is 
unsuccessful. The Top of File (or Top of Range) line becomes the new current 
line if the search was in a backward direction. With SET STAY ON, the 
current line remains the same. 

SET STAY applies also to the following subcommands: CHANGE, COUNT, 
COMPRESS, EXPAND, LOWERCAS, SET SELECT, SHIFT, and 
UPPERCAS. With SET STAY OFF, the last line examined or acted upon 
becomes the new current hne; with SET STAY ON, the hne pointer does not 
move when the subcommand is executed. 



Messages 



Return Codes 



520E Invalid operand: operand [RC = 5] 
545E Missing operand(s) [RC = 5] 



Normal 

5 Missing or invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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SET STREAM 



SET STREAM 



Format 



Operands 



Initial Setting 
Messages 

Return Codes 



Use the STREAM option to specify whether the editor is to search the entire file or 
only the current Une for a character string that is a column-target in a CLOCATE or 
CDELETE subcommand. 




ON 



specifies that the editor begins searching at the character following the column 
pointer and continues to the bottom of the file (or of the range). (If the search 
is in the other direction, the editor begins searching at the character preceding 
the column pointer and continues to the top of the file (or of the range)). 



OFF 



specifies that the editor searches only the current line (within the Umits defined 
by the SET ZONE subcommand). 



STREAM ON 



520E Invalid operand: operand [RC = 5] 
545E Missing operand(s) [RC = 5] 



Normal 

5 Missing or invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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SET SYNONYM 



SET SYNONYM 



The SET SYNONYM subcommand has three formats. 

Use the first format to specify whether or not the editor is to look for synonyms. 

Use the second format to assign a synonym to any existing subcommand or macro 
(except prefix subcommands or prefix macros) and, optionally, to define an 
abbreviation for the synonym. (You must use the SET PREFIX subcommand to 
define a synonym for a prefix subcommand or macro.) 

The third format provides a more complex function, which is used when the 
synonym represents a subcommand whose operands are entered in a different order 
than the XEDIT subcommand operands. The operands are automatically 
rearranged into the order expected by XEDIT. 



Format 



[set] 



SYNonym 



ON 
OFF 



SYNonym [LINEND char] newname [n] oldname 



SYNonym [ LINEND c/iar] newname \_n\formatl... format n'^ 
oldname [&l...&n] 



Operands 



ON 



specifies that the editor is to look for synonyms. 

OFF 

specifies that the editor is not to look for synonyms. 

LINEND char 

specifies a character that is interpreted as a Une end character regardless of the 
current SET LINEND setting at the time the synonym is used. 

newname 

is the synonym to be assigned to the subcommand or macro. The synonym can 
be an alphabetic string from one to eight characters long, or it can be a single 
alphabetic, numeric, or special character. 

n 

is the minimum number of characters that must be entered for the synonym to 
be accepted, that is, its minimum abbreviation. If you omit n, the full synonym 
name (newname) must be entered. 

format l...formatn 

specifies the format for the "new" operands. Each operand must be entered in 
the format specified. Format is defined as one of the following: 

& the operand is delimited by blanks. 

&/ the operand is a string enclosed by delimiters, for example, /ABC/. 



310 VM/SP System Product Editor Command and Macro Reference 



SET SYNONYM 



&. the operand is the first of two strings that are separated by a common 

delimiter. The second string would be specified as &/. 
&* represents all the remaining data. 

oldname 

is the name of a subcommand or macro for which you are creating a synonym. 
It may be a compounded name (for example, QUERY PF) or a subcommand 
name followed by its arguments. 

&l....&n 

specifies the relative order in which the new operands are to be inserted in the 
XEDIT subcommand, even though they are entered in a different order with the 
synonym. &1 represents the first operand in the synonym operand list, &2 
represents the second operand, and so forth. The list specified here is positional 
and determines how the operands are to be rearranged. 



Initial Setting 








SYNONYM ON and the following synonyms are 




SET SYNONYM ALTER 


2 ALTER 




SET SYNONYM CAPPEND 


2 CAPPEND 




SET SYNONYM FILE 


4 COMMAND PFILE 




SET SYNONYM SSAVE 


2 COMMAND SAVE 




SET SYNONYM FFILE 


2 COMMAND FILE 




SET SYNONYM HELP 


1 HELP 




SET SYNONYM HEXTYPE 


4 HEXTYPE 




SET SYNONYM JOIN 


1 JOIN 




SET SYNONYM MODIFY 


3 MODIFY 




SET SYNONYM QUIT 


4 COMMAND PQUIT 




SET SYNONYM QQUIT 


2 COMMAND QUIT 




SET SYNONYM SAVE 


4 COMMAND PSAVE 




SET SYNONYM SPLIT 


2 SPLIT 




SET SYNONYM STATUS 


4 STATUS. 


Usage Notes 







1 . The "newname" operand can be the name of an existing XEDIT subcommand. 
In this case, the SYNONYM subcommand defines a new meaning for that 
subcommand name. The original meaning can be obtained by using: 

command oldname . . . 
or 

set synonym off 
oldname.. . 

2. Newname can be alphabetic or it can be a single special character. For example: 

syn / 1 clocate/ 

causes implicit LOCATEs, such as a /string/ target, to become CLOCATEs. 

3. A synonym should not be defined for a name that is already defined as a 
synonym. For example: 

synonym erase delete 
synonym remove erase 

If REMOVE is entered, the editor looks for a subcommand called ERASE, not 
for a subcommand called DELETE. 
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SET SYNONYM 



Messages 



Return Codes 



Examples 



synonym add delete 

synonym linend $ SXMS 1 ocate/A/$ADD 

If SXMS is entered, a line is added after the line containing string A. The 
DELETE does not occur. 



497E Minimum abbreviation is between SO and SI [RC = 5] 

520E InvaUd operand: operand 

544E Invalid hex data: xxxxxxxx [RC = 5] 

545E Missing operand(s) [RC = 5] 

547E Synonym definition incomplete [RC = 5] 

548E Invalid synonym operand: operand [RC = 5] 

549E Synonym abbreviation too large [RC = 5] 

550E Too many operands in synonym definition [RC = 5] 



Normal 

5 Missing or invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 



Simple form: 

1. syn down 1 up 

2. syn qpf query pf 

3. syn linend i QK 2 query pf| query pa [query enter 
Entering QK displays the PF, PA, and ENTER key settings. 

Complex form: 

1. syn putfile 3 & & & & put &4 &1 &2 &3 
If you enter the command as follows: 

put fn ft fm n 

The editor rearranges it as follows: 

put n fn ft fm 

2. syn alter 2 &. &/ &* change /X'&17X'&27&3 
This example translates the subcommand: 

alter /7B/15/ * * 

to the following: 

change /X'yB'/X'lS'/ * * 
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SET TABLINE 



SET TABLINE 



Format 



Operands 



Initial Setting 
Usage Notes 



Response 



Messages 



Use the TABLINE option to display, on a specified line, a "T" in every tab column 
according to the current tab settings (See SET TABS in this book). 




ON 

displays the tab line. 

specifies the Une in which the tab line is displayed. M stands for "middle of the 
screen" (rounded up for odd-sized screens). M may be combined with a 
constant positive or negative integer to mean n lines below the middle of the 
screen (M + n), or n lines above the middle of the screen (M — n). 



l+|-|« 



specifies the line in which the tab line is displayed, n or + n ( + is implicit) 
specifies that the tab line is displayed n lines from the top of the screen: - n 
specifies that the tab line is displayed n lines from the bottom of the screen. 



OFF 



removes the tab line from the screen. 



TABLINE OFF -3 (three Unes from the bottom of the screen). 



1. TABLINE can be set on the same line as the scale line (see SET SCALE). 

2. If a Une occupies more than one screen line and the tab Une is set on an adjacent 
Une, the tab line is not displayed. The tab line is redisplayed when the Une 
pointer moves to a file line that occupies only one screen line. 



The specified Une contains a "T" in every tab column. For example: 
TTTTTTTT 



520E Invalid operand: operand [RC = 5] 

52 1 E Invalid line number [RC = 5] 

526E Option option valid in display mode only [RC = 3] 

545E Missing operand(s) [RC = 5] 
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SET TABLINE 



Return Codes 



Normal 

3 Operand is valid only for display terminal 

5 Missing or invalid operand or number 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 



Examples 



tabline on m 
tabline on m + 3 

tabline on - 3 



displays the tab line in the middle of the screen. 

displays the tab line three lines below the middle of the 
screen. 

displays the tab Une three lines from the bottom of the 
screen. 
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SET TABS 



Format 



SET TABS 



Use the TABS option to define the logical tab stops for a file. 



[set] 



TABS 7i1[7i2...m28] 



Operand 



nl...n28 

define the column numbers for logical tab settings. You may specify up to 28 
numbers, separated from each other by at least one blank. 



Initial Setting 
Usage Notes 



i\Aessages 



Based on file type. See Appendix A, "File Type Defaults" on page 403. 



1. A SET IMAGE ON subcommand must be in effect for a X' 05' to be 
recognized as a tab character in ah input line. 

2. A line containing tab characters can be entered from the terminal or the console 
stack. A tab character in an input line causes "space" characters to be inserted 
up to (but not including) the next tab position. The "space" character is, in fact, 
the character defined by SET FILLER, whose default is a blank. 

3. The COMPRESS subcommand inserts tab characters in a hne and can be used 
with the EXPAND subcommand to realign data according to a SET TABS 
subcommand. (See "COMPRESS, EXPAND.") 

4. On a display terminal, the SET TABS subcommand controls not only the logical 
tab settings but also the physical tab settings. A PF key can be set up to 
function like a tab key on a typewriter (see SET PFn TABKEY); each time the 
PF key is pressed, the cursor moves to the next column as defined in the SET 
TABS subcommand. 

5. The default tab settings differ according to file type and can be displayed by 
QUERY TABS. 

6. To define a tabulation character, issue the CMS command, SET INPUT. For 
example: 

cms set input > 05 

defines a " > " as the tabulation character. 



520E Invalid operand: operand [RC = 5] 
545E Missing operand(s) [RC = 5] 

575E Invalid [argument or] {JOIN|SPLITlTABSlVERIFY|ZONE} columns 
defined [RC = 5] 
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SET TABS 



Return Codes 

Normal 

5 Missing or invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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SET TERMINAL 



SET TERMINAL 



Format 



Use the TERMINAL option to specify whether a terminal is to be used in line mode 
or in full screen mode. (This option is meaningful only on a display terminal.) 



[set] 



TERMinal Typewriter 
Display 



Operands 



initial Setting 
Usage Notes 



l\/lessages 



Return Codes 



Typewriter 

specifies that the display terminal is to be used in line mode. 

Display 

specifies that the terminal is to be used in full screen mode. 



TERMINAL DISPLAY 



1. With a remote display terminal, full screen performance depends on the line 
transmission rate; if it is too slow, Une mode (TYPEWRITER) may be specified. 

2. In case of a severe transmission error while in full screen mode (DISPLAY), the 
editor automatically switches to line mode (TYPEWRITER). 

3. If you are editing a file in full screen mode and you issue a DISCONN 
(disconnect) command, you must issue BEGIN after you reconnect, and then 
press ENTER to get the file image back on the screen. 

4. If you are editing a file in line mode (SET TERMINAL TYPEWRITER), 
XEDIT does not recognize which key caused an attention interrupt. The 
definition which will be executed will be the CP definition of that key. To 
QUERY keys in Hne mode, use the CP QUERY PFnn command. 



520E Invahd operand: operand [RC = 5] 

526E Option option vaUd in display mode only [RC = 3] 

545E Missing operand(s) [RC = 5] 



Normal 

3 Operand is valid only for display terminal 

5 Missing or invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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SET TEXT 



Format 



Operands 



Initial Setting 
Usage Notes 



Messages 



Return Codes 



Use the TEXT option to inform the editor and CMS if TEXT keys are available on 
the terminal. 




ON 



specifies that TEXT keys are available. You must issue a SET TEXT ON 
before using these keys so that proper character code conversion takes place. 



OFF 



specifies that no code conversion is to be performed for TEXT keys. 



Defined by the CMS setting. 



1. If a terminal is equipped with the TEXT feature, special TEXT keys are 
available. Before using these keys, you must inform the editor so that proper 
character code conversion takes place. There are two ways to inform the editor: 

a. Issue CMS SET TEXT ON. 

b. Issue the editor SET TEXT ON subcommand. 

2. Because the conversion is costly, it is recommended that you issue the XEDIT 
subcommand SET TEXT OFF when you stop using the special keys. 

3. Issuing SET TEXT ON while APL is ON causes APL to be set to OFF. 
Similarly, issuing SET APL ON while TEXT is ON causes TEXT to be set to 
OFF. 

4. Changing the TEXT setting for XEDIT also changes the TEXT setting for 
CMS. 



520E Invalid operand: operand [RC = 5] 
545E Missing operand(s) [RC = 5] 



Normal 

5 Missing or invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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SET TOFEOF 



SET TOFEOF 



Format 



Operands 



Initial Setting 
Messages 

Return Codes 



Use the TOFEOF option to control the display of the following notices: 

Top of File 
End of File 
Top of Range 
End of Range. 




ON 



specifies that the notices listed above are displayed. 



OFF 



specifies that the notices listed above are not displayed. 



TOFEOF ON 



520E Invalid operand: operand [RC = 5] 
545E Missing operand(s) [RC = 5] 



Normal 

5 Missing or invaUd operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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SET TRANSLAT 



SET TRANSLAT 



Format 



Use the TRANSLAT option to control uppercase translation of specified characters. 
This option is designed to be used on terminals whose keyboards support characters 
other than English. By default, only EngUsh alphabetic characters are translated to 
uppercase. 



[set] 



TRANSLat 



charl 
OFF 



char 2 [charl char 2} 



Operands 



Initial Setting 
Usage Notes 



Messages 



Return Codes 



charl charl 

define a lowercase/uppercase pair of characters. Charl is the lowercase 
character, and char2 is the uppercase character. Either may be specified as a 
single EBCDIC character or a two-digit hexadecimal character. 



OFF 



indicates that characters are not to be translated to uppercase. 



Only English characters are translated to uppercase. 



1. For data Unes, translation occurs only if SET CASE UPPER is in effect or if a 
Une(s) is changed to uppercase (by the UPPERCAS subcommand, for example). 
An existing data line is not translated to uppercase unless a change is made to 
the line, in which case the entire line is translated. 

2. Commands are translated if SET CASE UPPER is in effect. 

3. Translation specified by SET TRANSLAT occurs only for uppercase. For 
lowercase, the system-supplied translate table is used. 



520E Invalid operand: operand [RC 
545E Missing operand(s) [RC = 5] 



5] 



Normal 

5 Missing or invahd operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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SET TRANSLAT 



Examples 

Assuming the terminal keyboard has the French character set and SET CASE 
UPPER: 

set translat 51 E 

(X'5r is "e" acute.) 

User enters: 

// / / 
liberte egalite fraternite 

which results in: 

LIBERTE EGALITE FRATERNITE 
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SET TRUNC 



SET TRUNC 



Format 



Operand 



Initial Setting 
Usage Notes 



Messages 



Return Codes 



Use the TRUNC option to define the truncation column, which is the last column in 
a line in which data may be entered or modified. 




specifies the column at which truncation (or "spiUing" — see SET SPILL) occurs. 
If you specify an asterisk (*), the truncation column is set to the record length 
for the file type. 



Based on file type. See Appendix A, "File Type Defaults" on page 403. 



1. Data that is entered beyond the truncation column is not shifted due to 
character insertion or deletion. 

2. When editing a file in update mode, you cannot SET TRUNC to a value greater 
than 72. 



009E Column nn exceeds record length {nn) [RC = 5] 

520E Invalid operand: operand [RC = 5] 

543E Invalid number: number [RC = 5] 

545E Missing operand(s) [RC = 5] 

560E Not enough space for serialization between TRUNC and LRECL 



Normal 

5 Missing or invalid operand or number 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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SET VARBLANK 



SET VARBLANK 



Format 



Operands 



Initial Setting 
Usage Notes 



IVIessages 



Return Codes 



Use the VARBLANK option to control whether or not the number of blank 
characters between two words is significant in a target search. 




ON 



specifies that the number of blanks between two words can be variable and does 
not matter in searching for a target. 

For example: 

/the house/ 

will match in the text: 
"the house" 

and will also match 
"the house" 



OFF 



specifies that the number of blanks between two words is significant in a target 
search. Each blank in the target string matches one blank in the file. 



VARBLANK OFF 



1 . SET VARBLANK ON is useful when editing text files, if periods at the end of 
sentences are not always followed by the usual two blanks or SCRIPT output 
files, where multiple blanks are generated between words for justification. 

2. SET VARBLANK ON is useful with SET SPAN ON. 



520E Invalid operand: operand [RC = 5] 
545E Missing operand(s) [RC = 5] 



Normal 

5 Missing or invaUd operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 



Chapter 3. XEDIT Subcommands and Macros 323 



SET VERIFY 



SET VERIFY 



Format 



Use the VERIFY option: 

• To control whether or not lines that are changed by subcommands are to be 
displayed (in the message area, for a display terminal) 

• To define the columns that are to be displayed when a file appears on the screen. 
Optionally, data may be displayed in hexadecimal notation. * 



[set] 


Verify ON LLHex] startcol endcol_ 

OFF [[Hex] startcol endcol^ 

[Hex] startcol endcol 


, 



Operands 



ON 



specifies that all lines changed by subcommands are to be displayed. (This is the 
initial setting for a typewriter terminal.) 



OFF 



specifies that lines changed by subcommands are not to be displayed. (This is 
the initial setting for a display terminal.) 

Hex 

displays the data in hexadecimal notation. 

startcol endcol 

is a pair of column numbers that defines an area to be displayed. 



Initial Setting 



Usage Notes 



Based on file type. See Appendix A, "File Type Defaults" on page 403. 

1. Up to 28 pairs of columns may be specified. For example: 

V 1 20 40 50 

displays columns 1 through 20, and 40 through 50. 

2. An area can be displayed in both EBCDIC and hexadecimal. For example: 

V 1 20 H 1 20 

displays columns 1 through 20 in both EBCDIC and hexadecimal. 

3. The data can be changed in either the EBCDIC or the hexadecimal display. If 
changed in the hexadecimal display, changes must be entered in hexadecimal. If 
you type an invalid hexadecimal code, the following message is displayed on the 
first line of the screen (the file identification Une): 

Invalid hex-data on screen: 
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SET VERIFY 



4. The SET IMAGE setting affects the way that hexadecimal data is treated. An 
example of this would be, if IMAGE is ON and you enter a X'05 ', it will 
expand into X'40's (or to whatever the FILLER character is in hexadecimal) to 
the next tab position. 

5. In multiple views of the same column, if changes are made on the screen the 
right-most change is the effective one. 

6. The columns specified in a SET VERIFY subcommand override any RIGHT or 
LEFT subcommand that was in effect. 

7. The editor displays a file line on as many screen lines as necessary. You can 
turn off this "automatic line wrapping" feature by issuing the appropriate SET 
VERIFY subcommand. 

For example, the default VERIFY setting for a SCRIPT file type is 1-132. To 
display only columns 1-72 of each line, thereby preventing lines longer than 72 
characters from wrapping around to the next screen line, you could issue SET 
VERIFY 1 72. (You could then use a RIGHT subcommand to view the 
columns of data extending past column 72.) 

Automatic Une wrapping is not available on vertical screens. 

8. For typewriter terminals, the maximum verify width is 132. 



Messages 



009E Column nn exceeds record length (nn) [RC = 5] 

520E Invalid operand: operand [RC = 5] 

545E Missing operand(s) [RC = 5] 

575E InvaUd [argument or] {JOINiSPLIT|TABS|VERIFY|ZONE} column(s) 

defined [RC = 5] 
576E {Total verify width exceeds screen size (««)| Total offset exceeds LRECL 

(««)}[RC = 5] 
58 IE Subcommand is not valid in extended mode [RC = 3] 



Return Codes 



Normal 

3 Subcommand is not valid in extended mode 

5 Missing or invaUd operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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SET WRAP 



SET WRAP 



Use the WRAP option to control whether or not the editor is to "wrap around" the 
file if the end of file (or range) is reached during a LOCATE, CLOCATE, FIND, 
FINDUP, NFIND, or NFINDUP subcommand. 



Format 




Operands 



ON 



specifies that the editor is to continue the search up to the line preceding the 
current Une (or following the current Une, depending on the search direction). 
When a CLOCATE is issued, the search continues up to the character preceding 
the column pointer (or following the column pointer). 



OFF 



specifies that the editor is to stop searching at the end (or top) of file (or range). 



Initial Setting 
Messages 

Return Codes 



WRAP OFF 



520E Invalid operand: operand [RC 
545E Missing operand(s) [RC = 5] 



5] 



Normal 

5 Missing or invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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SET ZONE 



SET ZONE 



Format 



Use the ZONE option to define the columns (starting position and ending position) 
of each record to be scanned for target searches. The editor searches for targets only 
within the zone. 




Operands 



Initial Setting 
Usage Notes 



zonel 

is the starting (left) column number of the zone. 

zone2 

is the ending (right) column number of the zone. If you specify an asterisk (*), 
zone2 is the truncation column. (Zone2 cannot be larger than the truncation 
column.) 



The ZONE is set from the first tab column up to the truncation column. 



1 . Column pointer movement is limited by the zone definition: the CFIRST 
subcommand places the colimin pointer in column zonel; the CLAST 
subcommand places the column pointer in column zone2. 

2. When a character string that is the target of a search spans several lines and the 
following subcommand has been issued: 

set span on noblank 

Column zone2 of the current Une is immediately followed by column zonel of 
the next line, with no intervening blank. 

If the following subcommand has been issued: 

set span on blank 

Column zone2 of the current Une is considered to be separated by a blank from 
column zonel of the next line. 

3. For a CHANGE subcommand, the string to be changed (string I) is searched for 
only within the defined zones. 
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SET ZONE 



Response 



When a SET ZONE subcommand is issued, its effect on column pointer movement 
is one of the following: 

• If the column pointer already lies between the two new zones, it remains 
unchanged. 

• If the current setting of the column pointer is less than zonel, it moves to the 
column defined by zonel — 1 (TOL). 

• If the current setting of the column pointer is greater than zone2, it moves to the 
column defined by zone2 + 1 (EOL). 



Messages 



520E InvaUd operand: operand [RC = 5] 
543E Invalid number: number [RC = 5] 
545E Missing operand(s) [RC = 5] 

575E InvaUd [argument or] {JOIN|SPLIT|TABS|VERIFY|ZONE} columns 
defined [RC = 5] 



Return Codes 



Normal 

5 Missing or invalid operand or number 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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SET = 



Format 



SET = 



Use the = option to insert the specified string into the equal ( = ) buffer. (See the 
subcommand.) 



SET 



string 



Operand 



Usage Note 

Message 
Return Codes 



string 

is any XEDIT subcommand or macro, except for the = subcommand (or any 
CP or CMS command, if SET IMPCMSCP is in effect). 



The subcommand SET is required with this option (to avoid conflict with the 
subcommand. 



545E Missing operand(s) [RC = 5] 



Normal 

5 Missing operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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SHIFT 



SHIFT 



Format 



Use the SHIFT subcommand to move data to the right or to the left. Data loss is 
possible. 



SHift 


Left 
Right 


cols 

1 


target 
1 


1 



Operands 



Usage Notes 



Responses 



Left 

shifts data to the left. Data shifted to the left past the zonel column is lost. 
The line is padded with blanks to the right, up through the truncation column. 

Right 

shifts data to the right. Shifted data that extends past the truncation column 
may be lost (See usage note 2, below). The line is padded to the left with 
blanks. 

cols 

is the number of columns the data is to be shifted. 

target 

defines the number of lines to be shifted, starting with the current line, up to but 
not including the target line. If you enter an asterisk (*), the rest of the file is 
shifted. If you omit target, only the current line is shifted. 

A target may be specified as an absolute line number, a relative displacement 
from the current line, a line name, or a string expression. For more information 
on targets, refer to the LOCATE subcommand in this book and to the 
publication VM/SP System Product Editor User's Guide. 



The SHIFT subcommand should not be confused with LEFT, RIGHT, and SET 
VERIFY, which move the screen over the data, causing the data to appear to 
move in the opposite direction, and do not cause data loss. 

If SET SPILL OFF is in effect (the default), characters that have been shifted 
beyond the truncation column are truncated. If SET SPILL ON or SET SPILL 
WORD has been issued, characters that have been shifted beyond the truncation 
column are inserted in the file as one or more new lines, starting with the first 
character or word that would have gone beyond the truncation column. SET 
SPILL affects only SHIFT issued with the RIGHT operand. SET SPILL has no 
effect on SHIFT LEFT; data shifted to the left past zonel is lost. 



If you specify that a SHIFT is to occur on multiple lines and it does occur, the 
current line pointer will be 

a. Unchanged, if SET STAY ON has been issued 

b. Moved to the last line shifted, if SET STAY OFF is in effect (the default). 
The column pointer is not affected by SHIFT. 
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SHIFT 



Messages 



Return Codes 



504E nn line(s) { truncated | spilled} [RC = 3] 

520E Invalid operand: operand [RC = 5] 

543E Invalid number: number [RC = 5] 

545E Missing operand(s) [RC = 5] 

546E Target not found [RC = 2] 

585E No line(s) changed [RC = 1 or 4] 



Normal 

1 TOP or EOF reached during execution 

2 Target line not found 

3 Truncated or spilled 

4 No lines changed 

5 Invalid or missing operand or number 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 



Chapter 3. XEDIT Subcommands and Macros 331 



SI 



SI (Macro) 



Format 



Use the SI (Structured Input) macro to continuously add lines to a file. The first 
line is added following the line that contains the cursor. The cursor is then 
positioned at the column where the text on the preceding line begins. Each time that 
you type on the new line and then press the ENTER key, another new line is 
automatically added to the file. If nothing is typed on the added line, the line is 
deleted when the ENTER key is pressed. 



SI 



Usage Notes 

1 . SI can also be issued in the prefix area. See the SI prefix macro. 

2. Using SI you can add a blank line to a file by making at least one change on the 
line. The line is considered changed if you press the space bar or if you retype 
the mask characters (see SET MASK). Moving the cursor using the cursor 
position keys over a line does not change the line. 

3. After SI is terminated, the cursor is positioned at the indentation column of the 
last added line. 

4. As lines are added using SI, any data above the new line remains stationary 
while the data below scrolls down the screen. When the new line is one line 
above the bottom of the file area, adding more Hnes will scroll the data above 
the new line up the screen. Using multiple SI subcommands or other prefix 
subcommands along with SI may move the new line off the screen. The cursor 
may not be placed at the indentation column when multiple SI subcommands 
are issued. 

Note for Macro Writers 

SI uses the console stack to adjust the current line when anything is pending on the 
line that will become the current line. 



Responses 



The prefix area of the new line contains ' ' and the following message is 

displayed in the status area: 



This pending status allows you to continually add Unes after you have typed on the 
new line. 

By default, the prefix area for the line that is added is highUghted. For more 
information, refer to SET COLOR PENDING. 

Each line that is added is pre-fiUed with the current mask (see SET MASK). 
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SI 



Messages 



Return Codes 



Example 



520E Invalid operand: operand [RC = 5] 

529E SI is only valid in {display|editing} mode [RC = 3] 

56 IE Cursor is not on a valid data field [RC= 1 or 3] 



3 Cursor is not in a valid field, or SI is valid in display mode only 

5 Invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called ft-om the last file in the ring 



The following example shows how to use a PF key assigned the SI subcommand. 

To insert the names of more party guests into the following file: 

• Move the cursor to the line where you want to add a name. 

• Press the PF key assigned to SI. 
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SI 



PARTY LIST Al Ffln T 

Al F 80 Trunc=80 S1ze=13 Line=7 Co]=l 



Alt=0 



" * * * Top of File * * * 
= PARTY GUESTS 

Annette 
_ Jennifer 
Michael 
Robert 
PARTY FOOD 



+....2. 



•+....3. 



* * * 



Cake 
Cookies 
Ice Cream 
Pizza 

End of File * * * 



•+....6. 



■+....7. 





































X E I T 


1 File 



A new line is added after th^ u„. ,u 

the new i,ne contain '" 'ZZ ""'"'' '" ™- ^"^ P'^fi- 

«he indentation column of the previ^t';^:" " ""'''''""'' " 



area of 



PARTY LIST Al Ffln T 

' '' '^""^=^^ ^^^^=14 Line=7 Col-l Alt-O 



^ * * * Top of File * * * 
= PARTY GUESTS 

Annette 
Jennifer 

Michael 

Robert 

(... + 1 + 2 

PARTY FOOD ""••• •^^ ••• + ••■ .4. ... + . . 5 . . 



===== * * * 



Cake 
Cookies 
Ice Cream 
Pizza 

End of File * * * 



figure 15. SI Macro aaa- 

Macro - Adding the First New Line 
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pending. 



SI 



Type a name on the line and press the ENTER key. This results in a new 
Une being added following the one you just typed on. You can continue 
to enter names to the list by typing on the new line and pressing the 
ENTER key. 



PARTY LIST Al F 8G Trunc=80 Size=15 Line=7 Col=l AU=1 



* * * Top of File * * * 
PARTY GUESTS 

Annette 

Jennifer 

John 

Michael 
I...+....1.. ..+... .2. ...+.. ..3....+. 

Robert 
PARTY FOOD 



Cake 
Cookies 
Ice Cream 
Pizza 

* * End of File * * * 



' ' pending. 

Figure 16 (Part 1 of 2). SI Macro — Adds New Lines Until Null Line Entered 
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SI 



When you are finished adding names, then press the ENTER key without 
typing on the new line. In this example two more names were added before 
terminating SI. 



PARTY LIST Al F 80 Trunc=80 Size=14 Line=6 Col=l AU=1 



* * * Top of File * * * 
PARTY GUESTS 

Annette 

Jennifer 

John 

Nancy 
I. ..+....1.. ..+... .2. ...+.. ..3. 

James 

Michael 

Robert 
PARTY FOOD 



Cake 
Cookies 
Ice Cream 
Pizza 



X E D I T 1 File 



Figure 1 6 (Part 2 of 2). SI Macro — Adds New Lines Until Null Line Entered 
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SORT 



SORT (Macro) 



Format 



Operands 



Usage Notes 



Messages 



Use the SORT macro to arrange a specified number of file lines in ascending or 
descending EBCDIC order according to specified sort columns. 



SORT 


target .AJ 

[d] 


col 1 col 2 


.coll coll. 


... 



target 

specifies the number of lines to be sorted. Lines are sorted starting with the 
current line, up to but not including the target line. (If you specify an asterisk 
(*), lines are sorted starting with the current line to the end of the file.) 

A target may be specified as an absolute line number, a relative displacement 
from the current line, a line name, or a string expression. For more information 
on targets, refer to the LOCATE subcommand in this book and to the 
publication VMjSP System Product Editor User's Guide. 



D 



sorts the file in ascending EBCDIC order. This is the default. 



sorts the file in descending EBCDIC order. 



coll coll 

is a pair of numbers that define a sort field. Coll is the starting column of a 
sort field within each line. Coll is the ending column. You can specify as many 
sort fields as you want, as long as the total length of the fields does not exceed 
249. 



1. If SET CASE UPPERCASE/MIXED RESPECT has been issued, sorting is 
done in EBCDIC order. 

2. If SET CASE UPPERCASE/MIXED IGNORE has been issued, sorting is done 
in alphabetical order, with lowercase and uppercase representations of the same 
letter considered to be identical. 

3. SORT operates outside of the current SCOPE. (See Appendix B for more 
information about SORT and the SCOPE setting.) 

4. SORT cannot be issued when prefix subcommands or macros are pending and it 
cannot be issued from a prefix macro. 



009E Column exceeds record length [RC = 24] 

053E Invalid sort field pair defined [RC = 24] 

063E No sort Ust given [RC = 40] 

493E SORT invalid in update mode [RC = 3] 

545E Missing operand(s) [RC = 5] 



546E Target not found [RC = 2] 
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SORT 



Return Codes 



Example 



58 IE Subcommand is not valid in extended mode [RC = 3] 

588E Prefix subcommand waiting... [RC = 8] 

596E This module must be called within the editor [RC = 88] 



Normal 

1 TOP or EOF reached during execution 

2 Target line not found 

3 SORT cannot be used when a file is edited in UPDATE mode or extended 
mode 

5 Missing operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called fi-om the last file in the ring 

8 Prefix area contains pending subcommand or macro 

24 Invalid columns defined 

40 No list given 

88 Module must be called within the editor 



Suppose you are editing a file which has two fields of information. The first field, 
positioned between columns 8 and 16 of the file, contains a Ust of file names. The 
second field, positioned between columns 17 and 24 of the file, contains a list of file 
types. Issuing the command: 

sort * 17 24 8 16 

sorts the file by file type (columns 17 through 24) and, within each file type, by file 
name (columns 8 through 16). The asterisk tells XEDIT to sort the entire file. 
Because no sort order is specified, the file will be sorted in ascending order (the 
default). 
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SOS 



Format 



SOS 



The SOS (screen operation simulation) subcommand provides a set of functions to 
be used mainly in XEDIT macros or to be assigned to PF keys. 



SOS 


option 
Options: 






Alarm 


POP 




CLEAR 


PUsh 




LINEAdd 


TABB In aJ 




LINEDel 


TABCmd 




NUUs 


TABCMDB [n \l] 




NUUs ON 


TABCMDF .n \1. 




NUUs OFF 


TABF .n\l. 




PFn 





Operands 



ALarm 

Ring the terminal alarm the next time the display is refreshed. 

CLEAR 

Clears the screen. 

LINEAdd 

Add a blank Une after the line pointed to by the cursor. This is the initial 
setting of the PF2 key. 

LINEDel 

Delete the line pointed to by the cursor. 

NUlls 

Reverse the current setting of the "nulls" option for the Une pointed to by the 
cursor. 

NUls ON 

Change the trailing blanks to "nulls" for the line pointed to by the cursor. 

NUlls OFF 

Change the trailing "nulls" to blanks for the line pointed to by the cursor. 

PF« 

Depress a PF key where n is the key number 1-24. The data which had been 
assigned to the key is placed LIFO in the CMS console stack. 



POP 



Remove the top position from the cursor stack and place the cursor there. (See 
PUSH, below.) If the cursor is outside any logical screen, it is positioned in the 
upper left corner of the first logical screen. 



PUsh 



Save the current position of the cursor. The position is saved in a LIFO fashion 
in a five-position stack used only for this purpose. 
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SOS 



TABB (will 

Move the cursor backward to the previous "tab" position as indicated by the 
XEDIT subcommand, SET TABS. The "tab" operation may be performed n 
times with one (1) being the default. 

TABCmd 

Position the cursor at the command Une for the logical screen in which it 
currently resides. 

TABCMDB [wlU 

Move the cursor backward to the first encountered command line. When 
multiple logical screens are defined, moves the cursor to the command line of the 
previous logical screen. 

TABCMDF I«|ll 

Move the cursor forward to the first encountered command line. When multiple 
logical screens are defined, moves the cursor to the command line of the next 
logical screen. 



TABF [will 

Move the cursor forward to the next 
subcommand, SET TABS. The "tab' 
one (1) being the default. 



'tab" position as indicated by the XEDIT 
operation may be performed n times with 



Usage Notes 



Messages 



Return Codes 



1. When the prefix is set on the left and the cursor is placed in the attribute byte 
following the line, TABF moves the cursor to the first tab column in the same 
Une and TABB moves the cursor to the last tab column of the preceding line. 

2. When using TABCMDF or TABCMDB, the view containing the first 
encountered command line becomes the file currently being edited. This 
switches editing to the next view displayed. As a result, if a TABCMDF or 
TABCMDB is issued when the commands are stacked (i.e., by a PF key), the 
stacked commands will be executed on the view containing the first encountered 
command line. 

3. With ETMODE ON, TABF with the cursor on the command Une can produce 
unpredictable results. 



520E Invalid operand: operand [RC = 5] 

529E Subcommand is only vahd in {display|editing} mode [RC = 3] 

545E Missing operand(s) [RC = 5] 

56 IE Cursor is not on a valid data field [RC = 1 or 3] 



Normal 

1 Cursor is on TOF or EOF line 

3 Invalid placement of cursor or subcommand, or subcommand is valid only for 
display terminal 

5 Missing or invaUd operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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SPLIT (Macro) 



Format 



Use the SPLIT macro to split a line into two or more lines. 

The first format allows you to split a line into two lines, at the column pointer or at 
the cursor. 

The second format allows you to split a line into several lines. 



SPlit 


LALigned] 


r Coluijin 1 
CURSOR 




[ALigned] 


colno 
Before 
.After 


/string 1 


... 



Operands 



ALigned 

gives the created line the same number of leading blanks as the original line. 

Column 

splits the current line into two lines. The second line starts with the data in the 
current column (as defined by the column pointer). The column pointer remains 
unchanged. If SPLIT is entered without an operand, SPLIT COLUMN is the 
default. 

CURSOR 

splits the line containing the cursor into two lines. The second line starts with 
the character under which the cursor was positioned. The cursor is not moved. 
This format of the SPLIT macro is especially useful when assigned to a PF key. 

colno 

specifies that the current line is to be split at the specified column number(s). 
The line is split as many times as there are operands. 

Before 

splits the current line before a specified character string. This is the default. 

After 

splits the current line after a specified character string. 

jstringl 

splits the current line before or after the specified character string. The line is 
split as many times as there are operands. 
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Usage Notes 



1. The SPLIT macro searches for strings in the current line with VARBLANK, 
SPAN, and STREAM all set to OFF (and restored after the SPLIT). 

2. SPLIT is the converse of JOIN. (See also SPLTJOIN, which combines the 
functions of SPLIT and JOIN.) 

3. The cursor or the column number or string specified must fall within the current 
zones. 



Responses 



The second line begins in column 1 unless SET IMAGE ON is in effect, in which 
case the second line begins in the first tab column. 

If the current line is split, the last line added becomes the new current line. If SPLIT 
CURSOR is issued, the line pointer remains unchanged. 

If a specified string is not found, an error message is issued and the current line 
remains the same. 



Messages 



Return Codes 



526E Option option valid in display mode only [RC = 3] 

557S No more storage to insert lines [RC = 4] 

56 IE Cursor is not on a vahd data field [RC = 1 or 3] 

575E Invahd [argument or] {JOIN|SPLIT|TABS|VERIFY|ZONE} column(s) 

defined [RC = 5] 

585E No line(s) changed [RC = 1 or 4] 

586E Not found [RC = 2] 



Normal 

1 No change (SPLIT issued at TOF or EOF) 

2 Not found 

3 Invalid placement of cursor or subcommand, or subcommand is valid only for 
display terminal 

4 No more storage 

5 Invalid operands 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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Examples 

Current Line: 

===== Electric eels can discharge bursts of 625 volts. 

Note the cursor position above. Press a PF key assigned to SPLIT CURSOR. 

===== Electric eels can discharge _ 
===== bursts of 625 volts. 

Current Line: 

===== Electric eels can discharge bursts of 625 volts. 

sp 29 (First line contains columns 1 through 28.) 

===== Electric eels can discharge 
===== bursts of 625 volts. 
Current Line: 

===== Electric eels can discharge bursts of 625 volts. 

sp aligned 23 (Split at column 23, but line up with first line.) 

===== Electric eels can 

===== discharge bursts of 625 volts. 

Current Line: 

===== Electric eels can discharge bursts of 625 volts. 
sp a/discharge / (Split the line after "discharge .") 

===== Electric eels can discharge 
===== bursts of 625 volts. 
Current Line: 

===== Electric eels can discharge bursts of 625 volts. 
sp 15 b/bursts/ (Split the line into three lines.) 

===== Electric eels 
===== can discharge 
===== bursts of 625 volts. 

The new current line is the last one that was added as a result of the split. 
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SPLTJOIN (Macro) 



Format 



Use the SPLTJOIN macro either to split a line or join two lines, depending on the 
position of the cursor on a file line. If the cursor is positioned before or at the last 
non-blank character, the Une is split (at the cursor position). If the cursor is 
positioned after the last non-blank character on a line (that is, after the end of the 
data on a line), the next Une is appended, starting at the cursor position. 



SPLTJOIN 



Usage Notes 



1. The SPLTJOIN macro is most useful when assigned to a PF key. The PFll key 
is initially set to SPLTJOIN. 

2. SPLTJOIN enables display terminal users to combine the functions of SPLIT 
CURSOR and JOIN CURSOR (see SPLIT and JOIN) on a single PF key. 
Unlike JOIN CURSOR, it prevents the accidental loss of data caused by joining 
two lines and overlaying data. 

3. SPLTJOIN functions like SPLIT and JOIN issued with the ALIGNED operand, 
that is, it "takes care of leading blanks. If a line is split, it adds the same 
number of leading blanks to the beginning of the new line as the original line 
has. If two lines are joined, it removes the same number of leading blanks from 
the line being joined as there are on the line to which it is appended. 

4. The cursor must lie with the current zones. 

5. If SET SPILL ON or SET SPILL WORD has been issued, characters that have 
been pushed beyond the truncation column are inserted in the file as one or 
more new lines, starting with the first character or word that would have gone 
beyond the truncation column. For the SPLTJOIN macro, SET SPILL OFF 
(the default) has the same effect as SET SPILL ON. SPLTJOIN does not 
truncate data. 

6. If two lines are joined, the original line appended as a result of the join is 
deleted. (The line pointer remains unchanged.) 



Messages 



503E (Truncatedl Spilled} [RC = 3] 

520E Invalid operand: operand [RC = 5] 

529E SPLTJOIN is only valid in {display|editing} mode [RC = 3] 

56 IE Cursor is not on a valid data field [RC = 1 or 3] 

585E No line(s) changed [RC = 1 or 4] 

557S No more storage to insert hues [RC = 4] 
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Return Codes 

Normal 

1 No change (SPLTJOIN issued at TOF or EOF) 

3 Spill occurred, or invalid placement of cursor or subcommand, or 
subcommand is valid only for display terminal 

4 No more storage 

5 Invalid operand 

6 Subcommand rejected in the PROFILE due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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STACK 



Format 



Use the STACK subcommand to place part or all of a specified number of lines 
(FIFO) in the console stack, starting with the current line. This subcommand is 
designed to be issued from a macro. 



STAck 




target 
1 


startcol 
1 


length 

ie 









Operands 



target 

defines the number of lines to be stacked. Lines are stacked starting with the 
current line, up to but not including the target line. If you specify an asterisk 
(*), the rest of the file is stacked. If you omit target, only the current line is 
stacked. 

A target may be specified as an absolute line number, a relative displacement 
from the current line, a line name, or a string expression. For more information 
on targets, refer to the LOCATE subcommand in this book and to the VM/SP 
System Product Editor User's Guide.. 



startcol 

specifies that lines are to be stacked starting in this column munber. 
startcol, the line is stacked starting at the first column. 



If you omit 



length 

specifies the number of columns that are to be stacked, starting with startcol. 
The maximum value for length is the truncation column. If you omit the length, 
the line is stacked up to the truncation column. 

Notes for Macro Writers 

1. STACK 110 stacks an empty Une. STACK also stacks an empty line. 

2. The CMS console stack restricts the length to be stacked to 255 bytes. To 
retrieve information about Hues that are longer than 255 bytes, use 
EXTRACT/CURLINE/ in a System Product Interpreter macro. 

3. The line pointer is moved to the last Une stacked. 

4. If a backward target is specified, for example, - 3, the lines are stacked in 
reverse order. 



Messages 



520E InvaUd operand: operand [RC = 5] 
543E Invalid number, number [RC = 5] 
546E Target not found [RC = 2] 
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Return Codes 



Normal 

1 TOF or EOF reached during execution 

2 Target line not found 

5 Invalid operand or number 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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STATUS (Macro) 



Format 



Use the STATUS macro to display the SET subcommand options and their current 
settings, or to create an XEDIT macro that contains the SET subcommand options 
listed under Usage Note 2. 



STATUS 



[filename] 



Operand 



Usage Notes 



filename 

specifies the name of a file that is to contain all the SET subcommand options 
Hsted in usage note 2. 

The editor assigns a file type of XEDIT; therefore, the file is an XEDIT macro. 
The macro can be invoked later to restore the SET subcommand options that 
were in effect when the STATUS macro was issued. 



1 . Use the STATUS macro without an operand to display the SET subcommand 
options and their current settings. All SET subcommand options are displayed 
except: 

ALT PF 

BRKKEY POINT 

ENTER RESERVED 

ETARBCH SELECT 

LASTLORC SIDCODE 

PA TRANS LAT 

PENDING = 

2. When you use the STATUS macro to create an XEDIT macro, you can later 
invoke the macro to restore the SET subcommand options that were in effect 
when the STATUS macro was issued. 

For example: 

status KEEP 

KEEP is the name of the macro. 
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Response 



Settings of the following subcommands are included in the macro: 



APL 


FNAME 


NULLS 


SPILL 


ARBCHAR 


FTYPE 


NUMBER 


STAY 


AUTOSAVE 


FULLREAD 


PACK 


STREAM 


CASE 


HEX 


PREFIX 


SYNONYM 


CMDLINE 


IMAGE 


RANGE 


TABLINE 


COLOR 


IMPCMSCP 


RECFM 


TABS 


COLPTR 


LINEND 


REMOTE 


TERMINAL 


CTLCHAR 


LRECL 


SCALE 


TEXT 


CURLINE 


MACRO 


SCOPE 


TOFEOF 


DISPLAY 


MASK 


SCREEN 


TRUNC 


ESCAPE 


MSGLINE 


SERIAL 


VARBLANK 


ETMODE 


MSGMODE 


SHADOW 


VERIFY 


FILLER 


NONDISP 


SPAN 


WRAP 


FMODE 






ZONE. 



7031 File filename XEDIT Al created 



Messages 



024E File fn XEDIT A already exists [RC = 28] 
520E Invalid operand: operand [RC = 5] 

67 IE Error {sending! receiving | creating! loading | updating} [file] fn ft fm, rc^ 
from [RC = 100] 



■nn 



Return Codes 





5 
6 

28 
100 



Normal 

Invalid operand 

Subcommand rejected in the profile due to LOAD error, or QUIT 

subcommand has been issued in a macro called from the last file in the ring 

File name specified already exists 

Error occurred while creating the file 
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TOP 



Format 



Use the TOP subcommand to move the line pointer to the null line above the first 
line of the file or of the range (see the SET RANGE subcommand). 



TOP 



Usage Note 



Responses 



TOP is the proper subcommand to use before a subcommand that searches for the 
first occurrence of a string in a file (such as LOCATE, FIND, etc.). If the current 
line is the first hne of the file, a string occurring in this line would be missed, 
because LOCATE, FIND, etc. start searching with the line following the current line. 



The null line at the top of the file becomes the new current line and contains: 



Message 
Return Codes 



* * * Top of File * * * 

The lines preceding the current line are blank, and the rest of the screen contains the 
beginning lines of the file. 



520E Invalid operand: operand [RC = 5] 



1 Top of file reached 

5 Invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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TRANSFER 



The TRANSFER subcommand is used within a macro to access specified editing 
variables, for example, the current line number, the file name of the file being edited, 
etc. The values that are transferred are placed in the console stack and can be read 
by subsequent EXEC 2 &READ control statements. More than one keyword can be 
specified in one TRANSFER subcommand placing the values last-in-first-out 
(LIFO) on the console stack. 

Only VM/SP Release 1 and Release 2 settings can be transferred. For example, 
TRANSFER CTLCHAR char does not transfer color and exthi attributes introduced 
in Release 3. The EXTRACT subcommand returns all settings and provides greater 
flexibiUty. 



Format 



TRAnsfer 


APL 


PFn 




ARBchar 


Point 




AUtosave 


PREfix 




CASE 


RANge 




CMDline 


RECFm 




COLPtr 


RESERved 




COLumn 


SCALe 




CTLchar ichar , 


SCReen 




CURLine 


Seq8 




CURSor 


SERial 




EOF 


SIDcode 




ESCape 


SIZe 




FILler 


SPAN 




FMode 


STAY 




FName 


STReam 




FType 


SYNonym [/la/nej 




HEX 


TABLine 




IMage 


TABS 




IMPcmscp 


TARGet 




LASTmsg 


TERMinal 




LENgth 


TEXT 




Line 


TOF 




LINENd 


TOFEOF 




LRecl 


TRunc 




LScreen 


UPDate 




MACRO 


VARblank 




MASK 


Verify 




MSGMode 


VERShift 




NBFile 


Width 




NONDisp 


WRap 




NULls 


Zone 




NUMber 


= 




PACK 
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Operands 



APL 

transfers "ON" or "OFF" as defined by the SET APL subcommand. 

ARBchar 

transfers "ON" or "OFF" and the arbitrary character specified in the SET 
ARBCHAR subcommand. 

AUtosave 

transfers the current AUTOSAVE setting: the AUTOSAVE count, file ID, and 
number of alterations. 

CASE 

transfers two values: the case setting ("U" or "M") and "R" or "I" as defined 
in the SET CASE subcommand. 

CMDline 

transfers an integer (n), which is the screen command line number defined by the 
SET CMDLINE subcommand. If SET CMDLINE TOP, n = 2. If SET 
CMDLINE ON, the number is the logical screen size minus one. If SET 
CMDLINE BOTTOM, n is the number of the last line on the logical screen. If 
SET CMDLINE OFF, n=0. 

COLPtr 

transfers "ON" or "OFF" as defined by the SET COLPTR subcommand. 

COLumn 

transfers the column number of the column pointer. 

CTLchar [char] 

If no character is specified (TRA CTLCHAR), transfers the control character 
identifier and all characters defined by the SET CTLCHAR subcommand, in the 
form "CTLCHAR ON ESCAPE char CTL cl c2 c3 c4. . .". If no control 
characters are defined, transfers "CTLCHAR OFF." 

If a character is specified (TRA CTLCHAR char), the attributes of that 
character are transferred, in the form "CTLCHAR char attribute 1 
PROTECTINOPROTECT attribute2 HIGH|NOHIGH|INVISIBLE." If no 
attributes were defined for the character, transfers "CTLCHAR." 

If the TRANSFER subcommand specifies multiple operands, the operand that 
follows CTLCHAR is interpreted as follows: if it is one character in length, it is 
interpreted as the "char" operand of CTLCHAR; if it is longer than one 
character or is not specified, it is handled normally. 

For example: 

transfer fn ft fm ctlchar Irecl recfm 

CTLCHAR is treated as if it were specified without the "char" operand. 
LRECL and RECFM are handled normally. 

transfer ctlchar t ctlchar " ctlchar % Irecl recfm 
transfers the attributes of 0, ", and %. 

CURLine 

transfers the Une number of the current line relative to the top of the screen, as 
defined by the SET CURLINE subcommand. 
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CURSor 

transfers four integers: the current position of the cursor on the screen (line 
number and column number) and the position of the cursor in the file (line 
number and colmnn number). If the cursor is in a protected area, two negative 
numbers (- 1) are transferred for the position of the cursor in the file. The top 
and bottom of the range are considered to be in the file. 

The current position of the cursor is the location where the cursor would be 
placed if the screen were displayed at this time. 

EOF 

transfers "ON" or "OFF" as determined by the editor. EOF is "ON" when the 
line pointer reaches end of file. 

ESCape 

transfers "ON" or "OFF" and the escape character (one-character string) 
defined by the SET ESCAPE subcommand. This character may be blank. 

FILler 

transfers the filler character (one-character string) defined by the SET FILLER 
subcommand. This character may be blank. 

FMode 

transfers the two-character file mode. 

FName 

transfers the eight-character file name. 

FType 

transfers the eight-character file type. 

HEX 

transfers "ON" or "OFF" as specified in the SET HEX subcommand. 

IMage 

transfers "ON," "OFF," or "CANON" as specified in the SET IMAGE 
subcommand. 

IMPcmscp 

transfers "ON" or "OFF" as specified in the SET IMPCMSCP subcommand. 

LASTmsg 

transfers the last message issued by the editor. This message may or may not 
have been displayed, depending on the SET MSGMODE subcommand 
operands. 

LENgth 

transfers the length of the current line from column one through the truncation 
column, excluding trailing blanks. 

Line 

transfers the current line number, relative to the beginning of the file. 

LINENd 

transfers "ON" or "OFF" and the line end character as defined by the SET 
LINEND subcommand. 

LRecl 

transfers the logical record length. 
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LScreen 

transfers six integers: the number of lines and the number of columns of the 
logical screen; the line number and column number defining the top left comer 
of the logical screen on the virtual screen; the number of lines and number of 
columns of the virtual screen. 

MACRO 

transfers "ON" or "OFF" as specified by the SET MACRO subcommand. 

MASK 

transfers the current mask line as defined by the SET MASK subcommand. The 
line may be all blanks. 

MSGMode 

transfers "ON" or "OFF" and "LONG" or "SHORT" as defined by the SET 
MSGMODE subcommand. 

NBFile 

transfers the number of files being edited. 

NONDisp 

transfers the character defined by the SET NONDISP subcommand. The 
character may be blank. 

NULls 

transfers "ON" or "OFF" as specified by the SET NULLS subcommand. 

NUMber 

transfers "ON" or "OFF" as specified by the SET NUMBER subcommand. 

PACK 

transfers "ON" or "OFF" as specified by the SET PACK subcommand. 

PFn 

transfers the string associated with a specified PF key, as defined by SET PFn. 
The string may be null or blank. 

Point 

transfers the symbolic name associated with the current line, as defined by the 
SET POINT subcommand or the .xxxx prefix subcommand, or transfers a blank 
string if no name has been defined. 

PREfix 

transfers "ON," "OFF," or "NULLS" and "RIGHT" or "LEFT" as specified in 
the SET PREFIX subcommand. 

RANge 

transfers two integers, which are the line numbers of the top and bottom of the 
range defined by the SET RANGE subcommand. 

RECFm 

transfers the record format, "F," "V," "FP," or "VP," defined by the SET 
RECFM subcommand. 

RESERved 

transfers as one line, the line numbers of reserved Unes. 

SCALe 

transfers "ON" or "OFF" and the scale line number as specified in the SET 
SCALE subcommand. 
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SCReen 

transfers "SIZE nl n2. . .," where nl is the number of Unes in the first logical 
screen, n2 is the number of Unes in the second logical screen, etc., as defined by 
the SET SCREEN subcommand. 

Seq8 

transfers "OFF" if the XEDIT command was issued with the NOSEQ8 operand; 
if not, transfers "ON." 

SERial 

transfers the serial identification or "OFF," the increment value, and the serial 
number starting value as defined by the SET SERIAL subcommand. 

SIDcode 

transfers the eight-character string specified in the SIDCODE option of the 
XEDIT command (or subcommand) or the LOAD subcommand. 

Size 

transfers the number of records in the file being edited. 

SPAN 

transfers three values: "ON" or "OFF," "B" or "N," and n, as defined in the 
SET SPAN subcommand. 

STAY 

transfers "ON" or "OFF" as specified in the SET STAY subcommand. 

STReam 

transfers "ON" or "OFF" as specified in the SET STREAM subcommand. 

SYNonym [name] 

TRANSFER SYNONYM transfers "ON" or "OFF" as specified in the SET 
SYNONYM subcommand. TRANSFER SYNONYM name transfers the name, 
its minimum abbreviation, and the associated synonym definition (that is, 
everything that was entered in the SET SYNONYM subcommand after the 
minimum abbreviation size). 

Note: In a TRANSFER subcommand with multiple keyword operands, 
SYNONYM must be the last one; otherwise, the keyword following 
SYNONYM would be interpreted as its operand and not as an independent 
keyword. 

TABLine 

transfers "ON" or "OFF" and n, as defined in the SET TABLINE 
subcommand. 

TABS 

transfers the tab column numbers defined by the SET TABS subcommand. 

TARGet 

transfers two pairs of integers pertaining to the character string that matches the 
last target located: line and column number of the first character in the string; 
line and column number of the last character in the string. 

TERMinal 

transfers "DISPLAY" or "TYPEWRITER" as defined in the SET TERMINAL 
subcommand. 

TEXT 

transfers "ON" or "OFF" as specified in the SET TEXT subcommand. 
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TOF 

transfers "ON" or "OFF" as determined by the editor. TOF is "ON" when the 
current line pointer reaches the top of file. 

TOFEOF 

transfers "ON" or "OFF" as specified in the SET TOFEOF subcommand. 

TRunc 

transfers the truncation column number as defined by the SET TRUNC 
subcommand. 

UPDate 

transfers "ON" or "OFF" as determined by the editor. Update is "ON" when 
the XEDIT command has been issued with the UPDATE or CTL operands. 

VARblank 

transfers "ON" or "OFF" as specified in the SET VARBLANK subcommand. 

Verify 

transfers "ON" or "OFF" and the verification columns specified in the SET 
VERIFY subcommand. 

VERShift 

transfers + n or — n, which is the relative position of the screen over the file, as 
a result of any LEFT or RIGHT subcommands. 

Width 

transfers the WIDTH value as specified in the XEDIT command or LOAD 
subcommand or as determined by the editor. 

WRap 

transfers "ON" or "OFF" as specified in the SET WRAP subcommand. 

Zone 

transfers the left and right zone column numbers specified in the SET ZONE 
subcommand. 

transfers one line (up to 130 characters) that corresponds to the content of the 
"equal ( = ) buffer," The equal buffer contains the last executed subcommand or 
macro or CP/CMS command, or whatever has been specified in the SET = 
subcommand. 

Notes for Macro Writers 

1. Several values can be transferred in one TRANSFER subcommand. For 
example: 

transfer line size trunc 

The values can then be read by the macro. For example: 

&read vars &line &size &trunc 

The variables in the macro will now contain the current Une number, the size of 
the file, and the truncation column, respectively. 

2. Remember that some TRANSFER keywords are associated with a set of values 
(like CURSOR and TABS), or a character that may be blank (like ESCAPE), or 
a text hne of varying length (like LASTMSG). When using TRANSFER with 
one of these keywords, it may be preferable not to specify multiple keywords in 
one TRANSFER and to make proper use of the &READ VARS, &READ 
ARGS, or &READ STRING control statements. 
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Message 

545E Missing operand(s) [RC = 5] 

Return Codes 

Normal 

5 Missing operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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TYPE 



Format 



Use the TYPE subcommand to display a specified number of lines, starting with the 
current line. 




Operand 



Usage Notes 



target 

defines the number of lines to be displayed. Lines are displayed starting with the 
current line, up to but not including the target line. If you enter an asterisk (*), 
the rest of the file is displayed. If you omit target, only the current line is 
displayed. 

A target may be specified as an absolute line number, a relative displacement 
from the current line, a line name, or a string expression. For more information 
on targets, refer to the LOCATE subcommand in this book and to the 
publication VM/SP System Product Editor User's Guide. 



1. TYPE displays a Une according to the current SET VERIFY subcommand. 

2. TYPE displays the first 256 characters for each line in the message area. If the 
output exceeds the number of lines for the message line, then the output is 
passed to CMS. When full-screen CMS is ON the output will appear in the 
CMSOUT window. To see all of the information in the virtual screen, you can 
use the CMS SCROLL command. The screen will be cleared automatically 
when you scroll to the bottom of the virtual screen. An alternative way to clear 
the screen is to issue the CMS DROP WINDOW command. When full-screen 
CMS is OFF, press the CLEAR key to redisplay the file. 

3. If SET SHADOW ON and SET SCOPE DISPLAY are in effect, any shadow 
Unes within the lines being typed are also displayed: 

nn line{s) not displayed --- 

However, shadow lines are not included in the count of lines to be typed. 
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TYPE 



Responses 

The specified lines are displayed. 

The line pointer moves to the last line typed. 



If the line pointer has moved to the null End of File line, the last line displayed will 
be: 



5831 EOF: 

If the current line is the null Top of File and you issue the TYPE subcommand, the 
first line displayed will be: 

5841 TOF: 



Messages 



520E Invalid operand: operand [RC = 5] 
546E Target not found [RC = 2] 



Return Codes 

Normal 

1 TOF or EOF reached 

2 Target Hne not found 

5 Invalid operand 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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UP 



UP 



Format 



Operand 



Usage Note 



Response 
Messages 

Return Codes 



Use the UP subcommand to move the line pointer a specified number of Hnes 
toward the top of the file. 




is the number of lines the Hne pointer is to be moved toward the top of the file. 
If you specify an asterisk (*), the hne pointer moves to the "Top of File" line. If 
a number is not specified, the pointer is moved up only one hne. 



The UP subcommand is equivalent to a minus ( — ) target. For example: 

up 3 

is equivalent to 

-3 



The Hne pointed to becomes the new current line. 



520E Invahd operand: operand [RC = 5] 
543 E Invalid number: number [RC = 5] 



Normal 

1 Top of File reached and displayed 

5 Invalid operand or number 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 
subcommand has been issued in a macro called from the last file in the ring 
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Example 



Figure 17 is a before-and-after example of the UP subcommand. 



PURIST SCRIPT Al V 132 Trunc=132 Size=12 Line=8 Col=l Alt=0 



* * * Top of File * * * 
"THE PURIST" 

I GIVE YOU NOW PROFESSOR TWIST. 

A CONSCIENTIOUS SCIENTIST. 

TRUSTEES EXCLAIMED. "HE NEVER BUNGLES!" 

AND SENT HIM OFF TO DISTANT JUNGLES. 

CAMPED ON A TROPIC RIVERSIDE, 

ONE DAY HE MISSED HIS LOVING BRIDE. 

I...+....1.. ..+... .2. ...+.. ..3. ...+.. ..4. 

SHE HAD, THE GUIDE INFORMED HIM LATER. 

BEEN EATEN BY AN ALLIGATOR. 

PROFESSOR TWIST COULD NOT BUT SMILE. 

"YOU MEAN." HE SAID. "A CROCODILE." 

* * * End of File * * * 



===> up 5 



X E D I T 1 File 



PURIST SCRIPT Al V 132 Trunc=132 Size=12 Line=3 Col=l Alt=0 



* * * Top of File * * * 
"THE PURIST" 

I GIVE YOU NOW PROFESSOR TWIST. 

I. .. + ....1.. .. + ... .2. ... + .. ..3. ... + ....'« 

A CONSCIENTIOUS SCIENTIST. 

TRUSTEES EXCLAIMED, "HE NEVER BUNGLES!" 

AND SENT HIM OFF TO DISTANT JUNGLES. 

CAMPED ON A TROPIC RIVERSIDE, 

ONE DAY HE MISSED HIS LOVING BRIDE. 

SHE HAD, THE GUIDE INFORMED HIM LATER. 

BEEN EATEN BY AN ALLIGATOR. 

PROFESSOR TWIST COULD NOT BUT SMILE. 

"YOU MEAN," HE SAID, "A CROCODILE." 

* * * End of File * * * 



Figure 17. The UP Subcommand — Before and After 



X E D I T 1 File 
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UPPERCAS 



Format 



Use the UPPERCAS subcommand to translate all lowercase characters to uppercase, 
starting at the current line, for a specified number of lines. 



UPPercas 



[target |l] 



Operand 



Usage Note 



Responses 



Messages 



Return Codes 



target 

defines the number of lines to be translated. Translation starts with the current 
line and continues up to, but does not include, the target line. If you specify an 
asterisk (*), the rest of the file is translated. If you omit target, only the current 
line is translated. 

A target may be specified as an absolute line number, a relative displacement 
from the current hne, a hne name, or a string expression. For more information 
on targets, refer to the LOCATE subcommand in this book and to the 
publication VM/SP System Product Editor User's Guide. 



The case setting defined in the SET CASE subcommand is not changed by 
UPPERCAS. 



1 . When you press the ENTER key, all lowercase letters within the current zones 
appear in uppercase. 

2. If you specify that UPPERCAS is to occur on multiple Unes and it does occur, 
the current line pointer will be: 

a. Unchanged if SET STAY ON has been issued. 

b. Moved to the last hne translated if SET STAY OFF is in effect (the 
default). 



520E Invahd operand: operand [RC = 5] 
546E Target not found [RC = 2] 
585E No hne(s) changed [RC = 4] 



Normal 

1 TOF or EOF reached during execution 

2 Target line not found 

4 No hues changed 

5 Invahd operand 

6 Subcommand rejected in the profile due to LOAD error,or QUIT 
subcommand has been issued in a macro called from the last file in the rim 
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Examples 



===== Elephant tusks can weigh up to 3G0 pounds. 

upp (translate the current line to uppercase) 

===== ELEPHANT TUSKS CAN WEIGH UP TO 300 POUNDS. 
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XEDIT 



XEDIT 



Format 



Use the XEDIT subcommand to edit multiple files. 



Xedit 



[fn [ft [fm]]] [(options... [)] ] 



Operands 



fn 



ft 



fm 



is the file name of a file to be brought into virtual storage. If the file is already 
in storage, no new copy is brought in. 

is the file type of the above file. If you omit ft, the editor uses the file type of 
the file you are currently editing. 

is the file mode of the file to be edited, indicating an accessed minidisk or SFS 
directory where the file resides. The editor determines the file mode of the 
edited file as follows: 

• Editing existing files. 

When the file mode is specified, that disk or directory and its extensions are 
searched. If the file mode is not specified or is specified as an asterisk (*), 
all accessed disks and/or directories are searched for the specified file. 

• Creating new files. 

If the file mode is not specified, the editor assumes a file mode of Al. 

options 

are the same as the options in the CMS command XEDIT. (See "Chapter 2: 
The XEDIT Command.") 



Usage Notes 



1 . The XEDIT subcommand allows you to independently edit multiple files in 
virtual storage. To edit another file in addition to the one(s) you are already 
editing, use the XEDIT subcommand and specify the new file ID. 

The files are placed in a ring. Each time the XEDIT subcommand is issued 
without arguments, the next file in the ring appears on the screen as the current 
file. This arrangement allows you to switch from the first file to the second, the 
second to the third, etc., all the way around the ring and back to the first. 

Each time the XEDIT subcommand is issued with a file ID, the file name and 
file type specified are compared to all files in the ring to determine if this file is 
already being edited. If a match is found, that file is made the current file and 
any options specified are ignored. If a match is not found, the specified file is 
brought into storage and becomes the current one. 

A QUIT or FILE subcommand issued from a file causes the previous file in the 
ring to be displayed. 
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Messages 



XEDIT 



2. XEDIT in update mode creates a, file with a file type of either UPDATE or the 
file type of the last update file applied, if any. The resulting file may have a file 
ID identical to that of a file already in the ring. XEDIT in member mode 
creates a file with file type MEMBER; this file may also have a file ID identical 
to that of a file already in the ring. 

3. When the screen is divided into multiple logical screens (see the SET SCREEN 
subcommand), entering the XEDIT subcommand with the same file ID from 
two (or more) logical screens creates two (or more) independent views of the 
same file. 

4. The file ID operands (fn ft fm) each may be specified with an equal ( = ) sign, in 
which case the value is the same as that in the current file. 

5. If this subcommand is issued as "CMS XEDIT. . .," XEDIT will be called 
recursively. (See the Usage Notes section of "Chapter 2: The XEDIT 
Command,.") 



002E File fn ft fm not found [RC = 28] 

003E Invalid option: option [RC = 24] 

024E File XEDTEMP CMSUTl Al already exists [RC = 28] 

029E Invalid parameter parameter in the option option field [RC = 24] 

048E Invalid mode mode [RC = 24] 

054E Incomplete fileid specified [RC = 24] 

062E Invalid character in fileid fn ft fm [RC = 20] 

065E option option specified twice [RC=24] 

066E optionl and option2 are conflicting options [RC = 24] 

069E Filemode mode not accessed [RC = 36] 

070E Invalid parameter parameter [RC =24] 

104S Error nn reading file fn ft fm from disk [RC = 31, 55, or 100] 

109S Virtual storage capacity exceeded [RC= 104] 

1 32S File fn ft fm too large [RC = 88] 

UTS Error nn on STATE for fn ft fm [RC = 88] 

229E Unsupported OS dataset, error nn [RC = 80, 81, 82, or 83] 

500E Unable to unpack file fn ft fm [RC = 88] 

508E LOAD must be the first subcommand in the profile [RC = 3] 

554E Not enough virtual storage available [RC= 104] 

555E File fn ft fm already in storage [RC = 4] 

5711 Creating new file: 

622E Insufficient free storage for {MSGLINE|PFkey/PAkey|synonyms} 

915E Maximum number of windows already defined [RC= 13] 

927E The virtual screen must contain at least 5 lines and 20 columns [RC = 24] 

928E Command is not vaUd for virtual screen CMS [RC = 12] 

1 1 38E File sharing conflict for file fn ft fm [RC = 70] 

1214W Fikfnftfm already locked SHARE 

1215E File fn ft fm is locked {SHARE|UPDATE|EXCLUSIVE} by another user 

[RC = 70] 

1262S Error nn opening niQfnftfm [RC = 31, 55, 70, 76, 99, or 100] 

1299W Warning: Not authorized to lock TilQfnftfm 

1300E Error nn (locking | unlocking} file/«/r {fm\dimame} [RC = 55, 70, 76, 99, or 
100] 
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Messages with Member Option 

007E File fn ft fm is not fixed, 80-character records [RC = 32] 

033E File fn ft fm is not a library [RC = 32] 

039E No entries in library fn ft fm [RC = 32] 

167S Previous MACLIB function not finished [RC = 88] 

622E Insufficient free storage for reading map [RC = 104] 

Messages witii Update Options 

007E File fn ft fm is not fixed, 80-character records [RC = 32] 

007E File fn ft fm does not have a logical record length greater than or equal to 

80[RC = 32] 

007E File /« /if /m does not have the same format and record length as /«/?/w 

[RC = 32] 

007E File fn ft fm is not fixed record format [RC = 32] 

104S Error nn reading file fn ft fm from disk [RC = 31, 32, or 55] 

174W Sequence error introduced in output file: seqnol Xo seqno2\R.C = 'i2] 

1 781 Applying fn ft fm 

179E Missing or invalid MACS card in control rHefnftfm 

1 80W Missing PTF file fn ft fm 

183E Invahd {CONTROL| AUX} file control card [RC = 32] 

184W ./ S not first card in update file-ignored [RC = 32] 

185W Non numeric character in sequence field seqno [RC = 32] 

186W Sequence number [seqnol] not found [RC = 32] 

207W Invalid update file control card [RC = 32] 

210W Input file sequence error: seqnol to seqno2 [RC = 32] 

570W Update ft specified in the UNTIL option field not found 

597E Unable to merge updates containing ./S cards [RC = 32] 

1262S Error nn opening file fn ft fm [RC = 31, 55, 70, 76, 99, or 100] 



Return Codes 



Normal 

4 File is already in storage 

6 Subcommand rejected in the profile due to LOAD error, or QUIT 

subcommand has been issued in a macro called from the last file in the ring 

12 Command is not valid for virtual screen 

13 Maximimi number of windows already defined 

20 Invalid character in file name or file type 

24 Invalid parameters or options 

28 Source file not found (UPDATE MODE), or library not found (MEMBER 

option), or specified PROFILE macro does not exist, or file XEDTEMP 

CMSUTl already exists 

31 A rollback occurred 

32 Error during updating process, or file is not a Ubrary, or Ubrary has no entries, 
or file is not fixed, 80 char, records 

36 Corresponding minidisk or directory not accessed 
55 APPC/VM communications error 
70 File sharing conflict 
76 Connection error 

80 An I/O error occurred while an OS data set or DOS file was being read or an 
OS or DOS disk was detached without being released. 

81 The file is an OS read-password-protected data set or a DOS file with the input 
security indicator on. 
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82 The OS data set or DOS file is not BPAM, BSAM, or QSAM. 

83 The OS data set or DOS file has more than 16 user labels or data extents. 

88 File is too large and does not fit into storage, or previous Maclib function was 

not finished 
99 A required system resource is not available 



100 Error reading the file into storage 
104 Insufficient storage available 
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& (Ampersand) 



& (Ampersand) 



Format 



Use an ampersand (&) at the command line before any subcommand to cause the 
subcommand to be redisplayed. 



& 



[subcommand} 



Usage Notes 



1. Using an & allows you to reexecute the subcommand just by pressing the 
ENTER key. You can also modify the command before reentering it. 

2. A synonym cannot be defined for &, 

3. The & subcommand must not be preceded by blanks. Also, & will cause trailing 
blanks in the subcommand that follows it to be replaced with nulls. 

4. MSGMODE must be ON in order for & to work properly. 
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= (Equal Sign) 



= (Equal Sign) 



Format 



Use the = subcommand to reexecute the last subcommand or macro or CP/CMS 
command entered, or to execute a specified subcommand and then reexecute the last 
one entered. 



isubcommand] 



Operand 



subcommand 

is any XEDIT subcommand (or any CP or CMS command, if SET IMPCMSCP 
ON is in effect). It is executed before the previous subcommand is reexecuted. 



Usage Notes 



1. Multiple adjacent = subcommands (= = = =) in the command line will cause 
the last subcommand to be executed as many times as there are equal signs 
specified. 

2. The last subcommand that is being reexecuted could have been entered from the 
command input area on the terminal, from the console stack (via a macro), or 
from any of the key settings (PF, PA, or ENTER keys). 

3. The editor keeps a copy of the last subcommand or macro in an equal buffer. 
The contents of this buffer may be: 

a. Displayed without being changed by using QUERY = 

b. Returned by using the EXTRACT subcommand (EXTRACT/ = /) 

c. Specified by using SET = string, where string becomes the new content of 
the equal buffer. 

4. The = subcommand may be renamed by using the SYNONYM subcommand. 

5. The editor assigns the = subcommand (with no operand) to the PF9 key. When 
the = subcommand is assigned to a PF or PA key, the default is ONLY = (see 
SET PF, SET PA). 

6. Entering the = subcommand in the format: 

= subcommand 

is useful if, for example, you enter a data line on a typewriter terminal while you 
are in command mode. Instead of switching to input mode and retyping the 
data Une, you can use the following subcommand: 

= input 

7. When the ENTER key is hit and nothing has been entered on the command line, 
the ENTER key definition, if any, is placed in the "equal buffer." 

8. The results of the execution of the = (Equal Sign) subcommand may not always 
be the same as that of the execution of the combination of the ? (Question 
Mark) subcommand and the ENTER key. The execution of certain defined PF 
keys, prefix subcommands, etc., can result in this difference. 
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? (Question Mark) 



Format 



Use the ? subcommand to display in the command area the last XEDIT 
subcommand (except for an = or ? subcommand), macro, or CP/CMS command 
executed from the command line. If none of these have been issued, then the ? 
subcommand will display the original CMS XEDIT command. 



Usage Notes 



1 . The subcommand that is displayed as a result of a ? can be reexecuted by 
pressing the ENTER key. You can also modify the command before reentering 
it. 

2. Successive execution of ? subcommands will display the previous subcommands. 
(The previous subcommands are maintained in a ring.) 

3. A synonym cannot be defined for the ? subcommand. 

4. The ? subcommand can be assigned to a PF or PA key. For example, the editor 
assigns the ? subcommand to the PF6 key and PA3 key (initial settings). When 
the ? subcommand is assigned to a PF or PA key, the default is ONLY ? (see 
SET PF, SET PA). 

5. Anything following a ? is ignored except another ?. Multiple ?s can be specified 
to retrieve previous subcommands. For example, ??? displays the third previous 
subcommand. 

6. Multiple subcommands ending with ? can be re-executed from the command line 
by pressing the ENTER key. For example, DEL#NEXT#? can be used 
repeatedly to delete every other hne from part or all of a file. 

7. The results of the execution of the = (Equal Sign) subcommand may not always 
be the same as that of the execution of the combination of the ? (Question 
Mark) subcommand and the ENTER key. The execution of certain defined PF 
keys, prefix subcommands, etc., can result in this difference. 

8. The ? subcommand must not be preceded by blanks. TraiUng blanks in the 
subcommand that is displayed as a result of a ? subcommand will be respected; 
they are not replaced with nulls. 

9. The ? subcommand has no effect if it is issued when the CMDLINE setting is 
OFF or if it is issued when the console stack is not empty. 
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Chapter 4. Prefix Subcommands and Macros 

Prefix subcommands and macros are "line" subcommands and macros, which are 
entered by typing over the five-position prefix area. You can use the prefix 
subcommands and macros to: 

Insert and delete Unes 

Continually add successive Unes 

Copy, move, and duplicate lines 

Extend the length of a line 

Move the current line pointer 

Display the scale on a particular line 

Display the tab settings on a particular line 

Assign a symbolic name to a Une 

Shift Unes left or right 

Exclude lines from display 

Redisplay (show) excluded lines. 

The prefix subcommands and macros are: 



A 


Add (equivalent to I) 


C 


Copy 


D 


Delete 


E 


Extend 


F 


FoUowing 


I 


Insert 


M 


Move 


P 


Preceding 


S 


Show excluded lines 


SCALE 


Display scale 


SI 


Add successive lines 


TABL 


Display tab line 


X 


Exclude lines 


.xxxx 


Assign symbolic name 


< 


Shift left 


/ 


Set current line 


> 


Shift right 


II 


DupUcate. 



General Usage Notes 



1. Use the subcommands 

set prefix on right 
or set prefix on left 

to display the five-position prefix area (= = = = =). 

You can use SET PREFIX NULLS to display nulls in the prefix area. 

2. Prefix subcommands and macros can be typed over any position of the 
five-character prefix area. 

For example: 

====a (adds a line) 
a==== (adds a Une) 
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==d== (deletes a line) 
5a=== (adds 5 lines) 
3 a== (adds 3 lines) 

are valid ways to enter prefix subcommands. You can type multiple prefix 
subcommands and macros before pressing the ENTER key. 

3. The prefix area is decoded in the following manner: 

• The prefix area is scanned to determine what has been entered. The scan 
starts at the right, looking for the first character that is different from the 
original prefix. If it finds one, it then scans starting at the left (as long as 
some of the prefix area has not been scanned yet), looking for the leftmost 
character that is different from the original prefix. 

• Any number is taken as an operand. 

• If the name starts with a letter, the name is decoded up to a non-alphabetic 
character. 

• If the name starts with a non-alphabetic character (a delimiter), the name is 
decoded up to a blank or an alphabetic character. 

• Whatever follows is taken as an operand. 
For example: 

PREFIX NAME OPl 0P2 0P3 



4a3 5 


a 


4 


3 


$XXX 


$ 


XXX 




»5 


» 


5 




5a>b 


a 


5 


>b 


5>ab 


> 


5 


ab 



4. If line numbers are displayed in the prefix area (via the SET NUMBER ON 
subcommand), use prefix subcommands and macros carefully. Some numbers 
that you type in the prefix area may be ignored. Only the characters that you 
type over and that are different from the numbers in the prefix area are 
interpreted as the prefix subcommand or macro. 

For example: 

The prefix area contains 12345 

You type "3a": 123a5 

The prefix subcommand is "a". 

The prefix area contains 12345 

You type "a4": la445 

The prefix subcommand is "a4". 

If you typed "a44": la445 

or if you typed "a445" : la445 

the editor would still interpret the prefix subcommand as being "a4," because 
the characters you type over must be different from the ones that are in the Une 
number. If you want "a44" to be recognized in this situation, type "a44" 
followed by a blank. 

5. When using SET PREFIX NULLS with SET NUMBER ON, use prefix 
subcommands and macros carefully. Some numbers that you type in the prefix 
area may be ignored. 
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For example: 

The prefix area contains 224 

You type "224a": 224a4 

The prefix subcommand is "a4". 

The prefix area contains 224 

You type "224a": 224a 

The prefix subcommand is "a". 

6. When you are editing a file on multiple screens (multiple views of the same file) 
prefix subcommands and macros may be specified on all of the views. 

If a prefix subcommand or macro is entered in more than one view of the file, 
but for the same file line, only the prefix subcommand or macro that is lowest 
and furthest to the right of the virtual screen will be executed. 

7. If a prefix subcommand or macro is entered incorrectly, it is displayed in the 
prefix area, prefixed by a quesfion mark (?). For example, if XX3 were entered 
(an invalid form of the X prefix macro), the prefix area would display ?XX3. 

If a prefix subcommand or macro causes a pending condition, or if the user 
entered an unknown prefix subcommand, the following pending notice is 
displayed in the status area: 

'value' pending 

where value is the name of the subcommand or macro that was entered. 

When XBDIT processes prefix subcommands and macros, it checks for syntax 
errors. If an error is found, the message is displayed in the screen it was entered 
in and the prefix subcommand is redisplayed, preceded by a ? in the screen in 
which it was entered. When the pending list is executed, if the prefix 
subcommand was entered on an invalid line, an error message will be displayed 
in the screen in which the pending list was executed and the prefix subcommand 
will be redisplayed on the line in which it was entered, preceded by a ?. 

Prefix macros are processed when the pending list is being executed. If an error 
is found in the prefix macro, the message will be displayed in the screen in which 
the pending Ust is executed. If the prefix macro indicates that the pending entry 
that was in error should be redisplayed (using SET PENDING ERROR), then 
that entry will appear in the same screen in which the error message appears. 

8. The RESET subcommand (entered on the command line) can be used to cancel 
any pending prefix subcommands or macros, that is, prefix subcommands or 
macros that have caused a pending notice to be displayed in the status area. 

Prefix subcommands and macros are executed before any subcommands 
executed by pressing a PA/PF key, the ENTER key, or before any 
subcommands that may be typed in the command line, including RESET. 

9. If you type a prefix subcommand or macro to delete, copy, or move a number of 
lines, and the number (n) you specify is greater than the number of lines left in 
the file, the number (n) is adjusted automatically to the number of lines left in 
the file. 
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10. The prefix subcommands and macros for a file are executed starting at the top 
of the file moving through to the end of the file. Block commands are executed 
when the end of the block is reached. Prefix subcommands or macros that 
cannot be executed or are not recognized are left pending. If the following 
prefix subcommands were entered, D would execute first, then M and F, 
followed by DD, which will be left pending because there is no matching entry. 
The numbers in parentheses indicate the order of processing. 

MM (2) 
D (1) 
MM (2) 
DD (3) 
F (2) 

1 1 . When multiple prefix subcommands and/or macros are issued, the cursor is 
positioned according to the one with the highest priority (see the CURSOR 
subcommand). 

The following is a list of the priorities associated with the prefix subcommands 
and macros (along with the priority assigned to changes on the screen and the 
ENTER key). 



SI 


Priority = 70 


E 


Priority = 60 


A.I 


Priority = 60 


/ 


Priority = 50 


II 


Priority = 40 


M 


Priority = 30 


C 


Priority = 30 


S 


Priority = 30 


X 


Priority = 30 


<>> 


Priority = 30 


ENTER key 


Priority = 30 


Screen change 


Priority = 20 


D 


Priority = 10 



For example, if both an A and a " prefix subcommand are typed and the ENTER 
key is pressed, the cursor is positioned on the screen where the new line was added 
by the A prefix subcommand (regardless of whether the " preceded or followed the A 
on the screen). 

If M and F prefix subcommands and a > prefix macro are typed and the ENTER 
key is pressed, the cursor is positioned either on the moved Une or on the shifted 
line, depending on which was specified first on the screen. 

Notes for Macro Writers 

1. For inforination on writing prefix macros, see the VM/SP System Product Editor 
User's Guide. See also: SET/QUERY/EXTRACT PENDING and 
SET/QUERY/EXTRACT PREFIX in this book. 

2. By using the CURSOR subcommand, user-written prefix macros can specify 
where the cursor is to be positioned as well as a priority for this cursor 
movement. The cursor is positioned at the location specified that has the highest 
priority when all pending prefix subcommands and macros are executed. 

3. Synonyms can be assigned for prefix macros by using the SET PREFIX 
subcommand with the SYNONYM option. See the VM/SP System Product 
Editor User's Guide for examples of using the SET PREFIX subcommand to 
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assign synonyms for prefix macros that you write. SET PREFIX subcommands 
used to assign synonyms can be entered in a user's PROFILE XEDIT file. 

The synonyms assigned to the XEDIT prefix macros are as follows: 
Macro Synonyin(s) File Identifier 

X, XX PREFIXX XEDIT 
S PRFSHOW XEDIT 
<, >, », « PRFSHIFT XEDIT 
SI XEDIT 
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A (ADD) 



Format 



Use the A prefix subcommand to add one or more lines immediately following the 
line in which the A prefix subcommand is entered. 



A - add one line 
wA - add n lines 
A« - add n lines 



Usage Note 
Responses 



Messages 



Return Codes 



Example 



The A prefix subcommand is equivalent to the I prefix subcommand. 



By default, the prefix area on each line that is added is highlighted. For more 
information, refer to SET COLOR PENDING. 

Each line that is added is pre-filled with the current mask (see SET MASK). 

If SET IMAGE ON is in effect, the cursor is placed in the first tab column of the 
first line that was added. Otherwise, it is placed in column 1 . 



529E Subcommand is only vahd in {display | editing} mode [RC = 3] 
557S No more storage to insert hues [RC = 4] 
659E Invalid prefix subcommand: prefix 



3 Terminal is not a display terminal 

4 Insufficient storage available 



Refer to the "Examples" section of the D prefix subcommand. 
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C (COPY) 



Format 



Use the C prefix subcommand to copy one line, a specified number of lines, or a 
block of lines. The F (Following) or P (Preceding) prefix subcommands must be 
used to indicate the destination of the copied line(s). 



C - 


copy line 


Cn - 


copy n lines 


nC - 


copy n lines 


CC - 


copy block of lines 



Usage Notes 



1 . Whenever you enter a C prefix subcommand, you also must enter an F or a P 
prefix subcommand in the prefix area of another line to indicate the destination 
of the copied line(s). The destination hne and the line(s) to be copied can be on 
different screen displays but must be within the same file. 

2. To copy one line, enter the character C in the prefix area of the line. 

3. To copy more than one hne, enter C« or nC in the prefix area of the first line of 
n hues to be copied. 

4. To copy a block of hnes, enter CC in the prefix areas of both the first and last 
lines, which can be on different screens. 



Responses 



The cursor is placed on the first line that was copied (at its new location) when that 
line is displayed on the resulting screen. If the first copied line was not displayed on 
the resulting screen, then the cursor will be positioned on the command line. 



The notice 



'C pending... 



is displayed in the status area until the required prefix subcommands have been 
entered, for example, when a C has been entered but an F or a P has not yet been 
entered. The "pending" status allows you to scroll through the file before entering, 
for example, the destination line. 

When a CC has been entered on only one hne of a block, the following message is 
displayed in the status area: 



'CC pending. 



This "pending" status allows you to scroll through the file before completing the 
block. 
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Messages 



557S No more storage to insert lines [RC = 4] 

659E Invalid prefix subcommand: prefix 

66 IE Prefix name is invalid for the line on which it was entered 



Return Codes 



Insufficient storage available 
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D 



D (DELETE) 



Format 



Usage Note 



Responses 



Messages 



Use the D prefix subcommand to delete one line, a specified nmnber of lines, or a 
block of lines. 



D - 


Delete one line 


Dn - 


Delete n lines 


^D - 


Delete n lines 


DD - 


Delete block of lines 



To delete a block of lines, enter DD in the prefix areas of both the first and last lines 
of the block to be deleted. The beginning and end of the block can be on different 
screens but must be within the same file. 



When a DD has been entered on only one line of a block of lines to be deleted, the 
following notice is displayed in the status area: 



'DD' pending. 



This "pending" status allows you to scroll through the file before completing the 
block. 

The cursor is placed on the command hne. If you want the cursor to be positioned 
on the line following the last Hne deleted, you must change the priority of the 
ENTER (or PA/PF) key. 



659E Invalid prefix subcommand: prefix 

66 IE Prefix name is invalid for the line on which it was entered 
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D 



Examples 

Figure 1 8 is a before-and-after example of the A and D prefix subcommands. 



ANIMALS FACTS Al F 80 Trunc=80 SizG=i4 Line=9 Co 1=1 Alt=0 

===== * * * Top of File * * * 

d==== THE HIPPOPOTAMUS IS DISTANTLY RELATED TO THE PIG. 

===== ELEPHANT TUSKS CAN WEIGH MORE THAN 300 POUNDS. 

===== LAND CRABS FOUND IN CUBA CAN RUN FASTER THAN A DEER. 

===== ELECTRIC EELS CAN DISCHARGE BURSTS OF 625 VOLTS, 

=2a== 40 TIMES A SECOND. 

===== THE ANCIENT ROMANS AND GREEKS BELIEVED THAT BEDBUGS HAD MEDICINAL 

===== PROPERTIES WHEN TAKEN IN A DRAFT OF WATER OR WINE. 

=dcl== STURGEON IS THE LARGEST FRESHWATER FISH AND CAN WEIGH 2250 POUNDS. 

===== ANTS HAVE FIVE DIFFERENT NOSES. EACH ONE IS DESIGNED TO 

I...+....1....+....2....+....3....+....4....+....5....+....6....+. 
=dd== ACCOMPLISH A DIFFERENT TASK. 
=A=== ALL OSTRICHES ARE POLYGAMOUS. 
===== SNAKES LAY EGGS WITH NONBRITTLE SHELLS. 

===== THE PLATYPUS HAS A DUCK BILL, OTTER FUR, WEBBED FEET, LAYS 
===== EGGS, AND EATS ITS OWN WEIGHT IN WORMS EVERY DAY. 
===== * * * End of File * * * 



X E D I T 1 File 






ANIMALS FACTS Al F 80 Trunc=80 Size=13 Line=9 Col=l Alt=l 

" * * Top of File * * * 

===== ELEPHANT TUSKS CAN WEIGH MORE THAN 300 POUNDS. 
===== LAND CRABS FOUND IN CUBA CAN RUN FASTER THAN A DEER. 
===== ELECTRIC EELS CAN DISCHARGE BURSTS OF 625 VOLTS, 
===== 40 TIMES A SECOND. 



THE ANCIENT ROMANS AND GREEKS BELIEVED THAT BEDBUGS HAD MEDICINAL 
PROPERIES WHEN TAKEN IN A DRAFT OF WATER OR WINE. 
ALL OSTRICHES ARE POLYGAMOUS. 
I...+....1....+....2....+....3....+....4....+....5....+....6....+. 

SNAKES LAY EGGS WITH NONBRITTLE SHELLS. 

THE PLATYPUS HAS A DUCK BILL, OTTER FUR, WEBBED FEET, LAYS 

EGGS, AND EATS ITS OWN WEIGHT IN WORMS EVERY DAY. 

* * * End of File * * * 



X E D I T 1 File 



Figure 18. Prefix Subcommands A and D — Before and After 
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E (EXTEND) 



Format 



E 



Use the E prefix subcommand to extend a logical line by one more virtual screen 
line. 



E 



Usage Notes 



Responses 
Messages 



1. After an E prefix subcommand is entered, the entire logical line, which now 
appears on two virtual screen lines, is treated as one line. Shifting due to 
character deletion and insertion affects the entire logical Une. 

2. The entire logical line visible on the screen does not exceed the maximum value 
defined by the SET VERIFY subcommand. 

3. A Une cannot be extended on a vertical screen (see SET SCREEN in this book). 



The cursor is positioned following the last non-blank character. 



659E Invalid prefix subcommand: prefix 

66 IE Prefix name is invalid for the Une on which it was entered 
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F (FOLLOWING) 



Format 



Use the F prefix subcommand to identify the line after which hnes are to be copied 
or moved via the C or M prefix subcommands. 



Respoirse 



The notice 



F' pending. 



is displayed in the status area if an F prefix subcommand has been entered and an 
associated C or M prefix subcommand has not yet been entered. The "pending" 
status allows you to scroll through the file before entering a C or M prefix 
subcommand. 



Message 
Example 



659E Invalid prefix subcommand: prefix 



See Figure 19 (the M prefix subcommand). 
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I (INSERT) 



Format 



Use the I prefix subcommand to insert one or more lines immediately following the 
line in which the I prefix subcommand is entered. 



I - Insert one line 
nl - Insert n lines 
In - Insert n lines 



Usage Note 
Responses 



Messages 



Return Codes 



The I prefix subcommand is identical to the A prefix subcommand. 



By default, the prefix area of each line that is inserted is highlighted. For more 
information, refer to SET COLOR PENDING. 

Each line that is inserted is pre-filled with the current mask (see the SET MASK 
subcommand). 

If SET IMAGE ON is in effect, the cursor is placed in the first tab column of the 
first line that was inserted. Otherwise, it is placed in column 1. 



529E Subcommand is only valid in {display|editing} mode [RC = 3] 
557S No more storage to insert Unes [RC = 4] 
659E Invalid prefix subcommand: prefix 



3 Terminal is not a display terminal 

4 Insufficient storage available 
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M 



M (MOVE) 



Format 



Use the M prefix subcommand to move one line, a specified number of lines, or a 
block of lines from one location to another in the file. The original lines are deleted. 
The F (Following) or P (Preceding) subcommand must be used to indicate the 
destination of the lines that are moved. 



M - 


move one line 


Mn - 


move n lines 


nU - 


move n lines 


MM - 


move block of lines 



Usage Notes 



1 . Whenever you enter an M prefix subcommand, you also must enter an F or a P 
prefix subcommand in the prefix area of another Une to indicate the destination 
of the lines to be moved. The destination line and the Hne(s) to be moved can 
be on different screen displays but must be within the same file. 

2. To move one line, enter the character M in the prefix area of the line. 

3. To move more than one Hne, enter Mn or «M in the prefix area of the first hne 
of n Unes to be moved. 

4. To move a block of Unes, enter MM on both the first and last Unes, which can 
be on different screen displays but must be within the same file. 



Responses 



The notice 



'M' pending. 



is displayed in the status area until the required prefix subcommands have been 
entered, for example, when an M has been entered but the F or P has not yet been 
entered. The "pending" status aUows you to scroll through the file before you enter 
another prefix subcommand (the destination Une, for example). 

When an MM has been entered on only one Une of a block, the following notice is 
displayed in the status area: 



pending. 



This "pending" status allows you to scroll through the file before completing the 
block. 

After the move, the cursor is positioned on the first Une that was moved when that 
line is displayed on the resulting screen. If the first line that was moved is not 
displayed on the resulting screen, then the cursor will be positioned on the command 
Une. 



384 VM/SP System Product Editor Command and Macro Reference 



M 



Messages 



Return Codes 



659E Invalid prefix subcommand: prefix 

66 IE Prefix name is invalid for the line on which it was entered 

557S No more storage to insert lines [RC = 4] 



Insufficient storage available 
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M 



Example 



Figure 19 is a before-and-after example of the M and F prefix subcommands. 



ANIMALS FACTS Ai V 132 Trunc=i32 Size=22 Line=10 Col=l Alt=0 

===== CHAMELEONS, REPTILES THAT LIVE IN TREES. CHANGE THEIR COLOR WHEN 

===== EMOTIONALLY AROUSED. 

===== THE GUPPY IS NAMED AFTER THE REVEREND ROBERT GUPPY, WHO FOUND THE FISH 

===== ON TRINIDAD IN 1866. 

===== AN AFRICAN ANTELOPE CALLED THE SITATUNGA HAS THE RARE ABILITY TO 

SLEEP UNDER WATER. 

=mm== THE KILLER WHALE EATS DOLPHINS, PORPOISES, SEALS, PENGUINS, AND 
===== SQUID. 

===== ALTHOUGH PORCUPINE FISHES BLOW THEMSELVES UP AND ERECT THEIR SPINES, 
===== THEY ARE SOMETIMES EATEN BY SHARKS. NO ONE KNOWS WHAT EFFECT THIS 

I...+....1....+....2....+....3....+....4....+....5....+....6....+....7. 
===mni HAS ON THE SHARKS. 

===== A LIZARD OF CENTRAL AMERICA CALLED THE BASILISK CAN RUN 
===== ACROSS WATER. 

===== OCTOPI HAVE LARGE BRAINS AND SHOW CONSIDERABLE CAPACITY FOR 
===== LEARNING. 

f==== THE LION ROARS TO ANNOUNCE POSSESSION OF A PROPERTY. 
===== A FISH CALLED THE NORTHERN SEA ROBIN MAKES NOISES LIKE A WET 
===== FINGER DRAWN ACROSS AN INFLATED BALLOON. 
===== STINGAREES, FISH FOUND IN AUSTRALIA, CAN WEIGH UP TO 800 POUNDS. 






X E D I T 1 File 



ANIMALS FACTS Al V 132 Trunc=132 Size=22 Line=7 Col=l Alt=l 



* * * Top of File * * * 

CHAMELEONS, REPTILES THAT LIVE IN TREES, CHANGE THEIR COLOR WHEN 

EMOTIONALLY AROUSED. 

THE GUPPY IS NAMED AFTER THE REVEREND ROBERT GUPPY, WHO FOUND THE FISH 

ON TRINIDAD IN 1866. 

AN AFRICAN ANTELOPE CALLED THE SITATUNGA HAS THE RARE ABILITY TO 

SLEEP UNDER WATER. 

A LIZARD OF CENTRAL AMERICA CALLED THE BASILISK CAN RUN 

I...+....1....+....2....+....3....+....4....+....5....+....6....+....7.. 

ACROSS WATER. 

OCTOPI HAVE LARGE BRAINS AND SHOW CONSIDERABLE CAPACITY FOR 

LEARNING. 

THE LION ROARS TO ANNOUNCE POSSESSION OF A PROPERTY. 

THE KILLER WHALE EATS DOLPHINS, PORPOISES, SEALS, PENGUINS, AND 

SQUID. 

ALTHOUGH PORCUPINE FISHES BLOW THEMSELVES UP AND ERECT THEIR SPINES, 

THEY ARE SOMETIMES EATEN BY SHARKS. NO ONE KNOWS WHAT EFFECT THIS 

HAS ON THE SHARKS. 

X E D I T 1 File 



Figure 19. Prefix Subcommands M and F — Before and After 
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P (PRECEDING) 



Use the P prefix subcommand to identify the line before which Unes are to be copied 
or moved via the C or M prefix subcommands. 



Format 



Response 

The notice 



'P' pending... 

is displayed in the status area if a P prefix subcommand has been entered and an 
associated C or M prefix subcommand has not yet been entered. The "pending" 
status allows you to scroll through the file before entering a C or M prefix 
subcommand. 



Message 

659E Invalid prefix subcommand: prefix 
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S (SHOW) Macro 



Use the S prefix macro to redisplay one or more lines that were excluded by the X 
prefix macro, the ALL macro, or other selective line editing subcommands (SET 
SELECT or SET DISPLAY). The S prefix macro can be entered only in the prefix 
area of a shadow Une (see SET SHADOW). 



Format 



s 


show all lines 


s* 


show all lines 


Sn 


show the first n lines 


S + n - 


show the first n lines 


nS 


show the first n lines 


S-n - 


show the last n lines 



Usage Notes 

1 . When n or + n is specified, Unes are redisplayed starting at the beginning of the 
group of excluded Unes. When — n is specified, Unes are redisplayed starting at 
the end of the group of excluded lines. (However, they are displayed in 
ascending order. For example, if Unes 1 through 10 are excluded, S-2 
redisplays Unes 9 and 10, in that order.) 

If +n or -n is larger than the number of excluded lines in the group, n is 
automatically adjusted to display all of the excluded lines. 

2. Redisplayed lines are included in the scope of regular editing subcommands. 

3. The S prefix macro alters the selection level (see SET SELECT) of the 
redisplayed Unes to the n2 value of SET DISPLAY nl[n2]. 

Note for Macro Writers 

The file identifier for the S prefix macro is PRFSHOW XEDIT. 



Responses 



Messages 



Return Codes 



If aU lines in a group of excluded Unes are redisplayed, the shadow Une disappears. 
If one or more lines remain excluded, the notice in the shadow line is adjusted 
accordingly. The cursor is placed on the first redisplayed line. 



646E macroname must be invoked from the prefix area [RC = 8] 

659E InvaUd prefix subcommand: prefix 

66 IE Prefix name is invalid for the Une on which it was entered 



8 Subcommand must be issued from prefix area 
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SCALE 



SCALE (DISPLAY SCALE) 



Format 



Use the SCALE prefix subcommand to display the scale on the corresponding screen 
Une. 



SCALE 



Usage Note 



Responses 



Message 



The SCALE prefix subcommand has the same effect as the subcommand: 

set scale on n 



The scale looks like this: 
<...+..|.l....+....2....+....3.>..+....4T...+....5....+....6....+....7, 



.column pointer 
left zone 



•truncation column 
right zone 



659E InvaUd prefix subcommand: prefix 
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SI 



SI (STRUCTURED INPUT) Macro 



Format 



Use the SI prefix macro to add a line immediately following the line on which SI 
was specified and position the cursor at the column where the text on the preceding 
line begins. Another new line will be added each time that you type on the new line 
and then press the ENTER key. SI continues to insert new lines until ENTER is 
pressed without typing on the new line. 



SI 



Usage Notes 

1. SI can also be issued as a subcommand. See the SI macro. 

2. Using SI you can add a blank Hne in a file by making at least one change on the 
new hne. The Hne is considered changed if you press the space bar or if you 
retype the mask characters (see SET MASK). Moving the cursor over a line 
using the cursor position keys does not change the hne. 

3. After SI is terminated, the cursor is positioned at the indentation column of the 
last added hne. 

4. As hues are added using SI, any data above the new hne remains stationary 
while the data below scrolls down the screen. When the new line is one line 
above the bottom of the file area, adding more lines will scroll the data above 
the new line up the screen. Using multiple SI commands or other prefix 
subcommands along with SI may move the new line off the screen. The cursor 
may not be placed at the indentation column when multiple SI subcommands 
are issued. 

Note for Macro Writers 

SI uses the console stack to adjust the current hne when anything is pending on the 
hne that will become the current line. 



Responses 



The prefix area of the new line contains ' ' and the following message is displayed 

in the status area: 



This pending status allows you to continually add hnes after you have typed on the 
new hne. 

By default, the prefix area for the line that is added is highhghted. For more 
information, refer to SET COLOR PENDING. 

Each Hne that is added is pre-filled with the current mask (see SET MASK). 
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SI 



Messages 

Return Codes 
Example 



529E SI is only valid in (display |editing} mode [RC = 3] 

659E Invalid prefix subcommand: prefix 

66 IE Prefix name is invalid for the line on which it was entered 



Terminal is not a display terminal 



To add more ingredients following the Une that contains the words "graham cracker 
crumbs," type SI in the prefix area of that line. 

===== Chocolate-Nut Cookie Ingredients 

===== 1/2 Pound butter 

=si== 1 1/2 Cups graham cracker crumbs 

===== 3 1/2 Ounces coconut flakes 

===== 2 Ounces chopped nuts 

Pressing the ENTER key results in a new line being added. Note that the prefix 

area of the new hne contains ' ' and that the cursor has been indented on the 

new line. 

===== Chocolate-Nut Cookie Ingredients 

===== 1/2 Pound butter 

===== 1 1/2 Cups graham cracker crumbs 

===== 3 1/2 Ounces coconut flakes 
===== 2 Ounces chopped nuts 

Type an ingredient on the new line and press the ENTER key. 

===== Chocolate-Nut Cookie Ingredients 

===== 1/2 Pound butter 

===== 1 1/2 Cups graham cracker crumbs 

8 Ounces sweetened condensed milk _ 

===== 3 1/2 Ounces coconut flakes 

===== 2 Ounces chopped nuts 

The ' ' notice and the cursor move from the line you just typed on to another 

new Hne. 

===== Chocolate-Nut Cookie Ingredients 

===== 1/2 Pound butter 

===== 1 1/2 Cups graham cracker crumbs 

===== 8 Ounces sweetened condensed milk 

===== 3 1/2 Ounces coconut flakes 
===== 2 Ounces chopped nuts 
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SI 



You can continue to enter ingredients by typing on the new line and pressing the 
ENTER key. When you are finished entering ingredients, then press the ENTER 
key (in this example the new line was unchanged). 

===== Chocolate-Nut Cookie Ingredients 

===== 1/2 Pound butter 

===== 1 1/2 Cups graham cracker crumbs 

===== 8 Ounces sweetened condensed milk 

===== 3 1/2 Ounces coconut flakes 

===== 2 Ounces chopped nuts 



392 VM/SP System Product Editor Command and Macro Reference 



TABL 



TABL (DISPLAY TAB LINE) 



Format 



Use the TABL prefix subcommand to display a "T" in every tab column, according 
to the current tab settings (see SET TABS in this book), on the corresponding screen 
hne. 



TABL 



Usage Note 



Responses 



Message 



The TABL prefix subcommand has the same effect as the subcommand: 
set tabline on n 

The Hne displays a "T" in every tab column: 

For example: 

TTTTTTTTT 

659E InvaUd prefix subcommand: prefix 
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X 



X (EXCLUDE) Macro 



Format 



Use the X prefix macro to exclude from the display either one line, a specified 
number of Hnes, or a block of lines. Lines excluded from the display are also 
excluded from the scope of editing subcommands (see SET SCOPE). 



X - 


exclude one line from display 


Xn - 


exclude n lines from display 


nX. - 


exclude n lines from display 


XX - 


exclude a block of lines from display 



Usage Notes 

1 . To exclude a block of lines, enter XX in the prefix area of both the first and last 
lines of the block, which can be on different screens but must be within the same 
file. 

2. Use the S (SHOW) prefix macro to redisplay the excluded lines. 

3. The lines excluded from display are also excluded from the scope of regular 
editing subcommands, unless you specify SET SCOPE ALL. 

4. The X prefix macro alters the selection level of the lines excluded (see SET 
SELECT). Excluded lines are assigned a selection level that is one greater than 
the end of the display range (see SET DISPLAY). If you have entered SET 
DISPLAY n *, the X prefix macro has no effect. The X prefix macro does not 
alter the settings of SET SCOPE, SET SHADOW, or SET DISPLAY. 

5. The hnes excluded are replaced with a "shadow hne" (see SET SHADOW), 
which indicates the number of lines excluded. If you do not want the shadow 
line displayed, issue SET SHADOW OFF. 

6. If a block of hnes to be excluded includes hnes that were previously excluded 
(that is, these Hnes are nested within the block), these hnes remain excluded. 
However, their selection level remains the same. The shadow hne shows the 
total number of hnes excluded. 

Note for Macro Writers 

The X prefix macro is an example of how selective hne editing subcommands (SET 
SELECT, SET DISPLAY, SET SCOPE, and SET SHADOW) can be used. The file 
identifier for the X prefix macro is PREFIXX XEDIT. 



Responses 



When XX has been entered on only one hne of a block of hnes to be excluded and a 
key is pressed, the XX prefix macro is displayed highlighted in the prefix area, and 
the status area displays the following pending notice: 



XX' pending. 



This "pending" status allows you to scroll through the file before completing the 
block. 
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Messages 



Return Codes 



The cursor is placed on the first Hne following the excluded line(s). 



646E macroname must be invoked from the prefix area [RC = 8] 

659E Invahd prefix subcommand: prefix 

66 IE Prefix name is invalid for the line on which it was entered 

686E Synonym name not recognized by prefix macro macroname 



8 Subcommand must be issued from prefix area 
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.xxxx 



.xxxx (SET SYMBOLIC NAME) 



Format 



Use the .xxxx prefix subcommand to assign a symbolic name to a line. One or more 
names can be defined for a line using separate .xxxx subcommands. You can use a 
symbolic name to refer to the line in subsequent target operands of XEDIT 
subcommands. 






Operand 



is a symbolic name for the line. The name must begin with a period and be 
followed by from one to four alphanumeric characters. For example, .AAA. 



Usage Notes 



1 . The .xxxx prefix subcommand is the same as the SET POINT subcommand, 
except that .xxxx Umits the name to four characters. 

2. The .xxxx prefix subcommand makes it unnecessary for you to remember or to 
look up the line number. A line can be referenced by its name at any time 
during an editing session. 

3. A symbolic name stays with a Une for the entire editing session, even if the line 
number changes due to insertion or deletion of other lines. However, you can 
delete a symbolic name by using the SET POINT subcommand (SET POINT 
.xxxx OFF). You can also delete a symbolic name for one line by using .xxxx 
to assign that name to another Hne. 

4. After a symbolic name is defined for a hne, the name does not appear in the 
prefix area. You must keep track of symbolic names. The subcommand 
QUERY POINT * can be used to display all names and their hne numbers 
currently defined for the file. The subcommand QUERY POINT can be used to 
display the name(s) of the current Une. 



Message 



659E Invahd prefix subcommand: prefix 

66 IE Prefix name is invahd for the hne on which it was entered 
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< (SHIFT LEFT) Macro 



Format 



Usage Notes 



Use the < prefix macro to shift one hne or a block of lines one or more columns to 
the left. 



< 


shift one line one column to the left 


<n 


shift one line n columns to the left 


n < 


shift one line n columns to the left 


< < 


shift a block of lines one column to the left 


< < n - 


shift a block of lines n columns to the left 


n < < - 


shift a block of lines n columns to the left 



1. Data shifted to the left past the zonel column is lost. The line is padded with 
blanks to the right, up through the truncation column. (The < prefix macro is 
comparable to the SHIFT subcommand issued with the LEFT operand.) 

2. To shift a block of hnes one column to the left, enter < < in the prefix areas of 
both the first and last hnes of the block. The beginning and end of the block 
can be on different screens but must be within the same file. 

To shift a block of hnes n columns to the left, enter < < n or n < < in either the 
first or last line of the block, and < < in the other. (If you enter a number on 
both the first and last lines of the block, the one closest to the end of file is 
used.) 



Note for Macro Writers 

The file identifier for the 



prefix macro is PRFSHIFT XEDIT. 



Responses 



When < < has been entered on only one line of a block of lines to be shifted and a 
key is pressed, the < < prefix macro is displayed highUghted in the prefix area, and 
the status area displays the following pending notice: 



:' pending.. 



This "pending" status allows you to scroll through the file before completing the 
block. 



Messages 



The cursor is placed on the first line shifted. 



646E macroname must be invoked from the prefix area [RC = 8] 

659E Invalid prefix subcommand: prefix 

66 IE Prefix name is invalid for the hne on which it was entered 

686E Synonym name not recognized by prefix macro macroname 
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Return Codes 

8 Subcommand must be issued from prefix area 
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/ (SET CURRENT LINE) 



Format 



Use the / (diagonal) prefix subcommand to set the current Une or to identify a hne 
that will be the new current line after other prefix subcommands are executed and, 
optionally, to move the column pointer. 



/[n] or [n]l 



Operand 



is the column number in which the column pointer is to be placed. 



Usage Notes 



1 . If several / prefix subcommands are typed on the screen, the last one will set the 
current line. 

2. If SET IMAGE ON is in effect, the cursor is placed in the first tab column of 
the new current line. Otherwise, it is placed in column 1 . 



Messages 



659E Invahd prefix subcommand: prefix 

66 IE Prefix name is invalid for the hne on which it was entered 
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> (SHIFT RIGHT) Macro 



Format 



Use the > prefix macro to shift one line or a block of lines one or more columns to 
the right. 



> 


shift one line one column to the right 


>n 


shift one line n columns to the right 


n > 


shift one line n columns to the right 


> > 


shift a block of lines one column to the right 


> > n - 


shift a block of lines n columns to the right 


n > > - 


shift a block of lines n columns to the right 



Usage Notes 

1. Shifted data that extends past the truncation column is either lost or "spilled" 
(see SET SPILL). The line is padded to the left with blanks. (The > prefix 
macro is comparable to the SHIFT subcommand issued with the RIGHT 
operand.) 

2. To shift a block of lines one column to the right, enter > > in the prefix areas 
of both the first and last lines of the block. The beginning and end of the block 
can be on different screens but must be within the same file. 

To shift a block of lines n columns to the right, enter > > n or n > > in either 
the first or last line of the block, and > > in the other. (If you enter a number 
on both the first and last lines of the block, the one closest to the end of file is 
used.) 

Note for Macro Writers 

The file identifier for the > prefix macro is PRFSHIFT XEDIT. 



Responses 



When > > has been entered on only one line of a block of lines to be shifted and a 
key is pressed, the > > prefix macro is displayed highlighted in the prefix area, and 
the status area displays the following pending notice: 

'»' pending... 

This "pending" status allows you to scroll through the file before completing the 
block. 



The cursor is placed on the first line shifted. 



Messages 



646E macroname must be invoked from the prefix area [RC = 8] 

659E InvaUd prefix subcommand: prefix 

66 IE Prefix name is invalid for the line on which it was entered 

686E Synonym name not recognized by prefix macro macroname 
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Return Codes 

8 Subcommand must be issued from prefix area 
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" (DUPLICATE) 



Format 



Use the " (double quote) prefix subcommand to duplicate one line or a block of 
lines, either one time or a specified number of times. 



// 


duplicate one line 


'* n ov n" 


duplicate line n times 


" " 


duplicate block of lines 


" "n or n" " 


duplicate block n times 



Usage Notes 



Responses 



Messages 



Return Codes 



1 . To duplicate a block of Unes, enter " " on both the first and last lines of the 
block. The beginning and end of the block can be on different screens. 

2. To dupUcate a block of lines n times, enter ""« or «"" on the first line of the 
block, and enter " " on the last Une of the block. 



When " " has been entered on only one Une of a block, the following notice is 
displayed in the status area: 

' pending... 



This "pending" status allows you to scroll through the file before completing the 
block. 

The cursor is positioned on the dupUcated line. 



659E Invalid prefix subcommand: prefix 

66 IE Prefix name is invaUd for the Une on which it was entered 

557S No more storage to insert Unes [RC = 4] 



Insufficient storage available 
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Appendix A. File Type Defaults 



FILE TYPE 


SERIAL TRUNC 


LRECL 


RECFM 


VERIFY 


ESCAPE 


CASE 


SPILL 


IMAGE 


$EXEC 


ON 


72 


80 


F 


72 




M 


OFF 


ON 


$XEDIT 


ON 


72 


80 


F 


72 




M 


OFF 


ON 


AMSERV 


ON 


72 


80 


F 


T 




U 


OFF 


ON 


ASM3705 


ON 


71 


80 


F 


T 




U 


OFF 


ON 


ASSEMBLE 


ON 


71 


80 


F 


72 




U 


OFF 


ON 


BASDATA 


OFF 


255 


255 


V 


T 




M 


OFF 


ON 


BASIC 


OFF 


156 


156 


V 


T 




M 


OFF 


ON 


CNTRL 


OFF 


80 


80 


F 


T 




U 


OFF 


ON 


COBOL 


ON 


72 


80 


F 


T 




U 


OFF 


ON 


COPY 


ON 


71 


80 


F 


T 




U 


OFF 


ON 


DLCS 


ON 


72 


80 


F 


72 




U 


OFF 


ON 


DIRECT 


ON 


72 


80 


F 


T 




U 


OFF 


ON 


ESERV 


ON 


71 


80 


F 


T 




u 


OFF 


ON 


EXEC 


OFF 


130 


130 


V 


T 




u 


OFF 


ON 


FORTRAN 


ON 


72 


80 


F 


T 




u 


OFF 


ON 


FREEFORT 


OFF 


81 


81 


V 


T 




u 


OFF 


ON 


GCS 


OFF 


130 


130 


V 


T 




u 


OFF 


ON 


GROUP 


ON 


71 


80 


F 


72 




u 


OFF 


ON 


JOB 


OFF 


80 


80 


F 


T 




u 


OFF 


ON 


LISTING 


OFF 


121 


121 


V 


T 




u 


OFF 


ON 


MACLIB 


OFF 


71 


80 


F 


72 




u 


OFF 


OFF 


MACRO 


ON 


71 


80 


F 


72 




u 


OFF 


ON 


MEMBER 


ON 


71 


80 


F 


72 




u 


OFF 


ON 


MEMO 


OFF 


80 


80 


V 


T 




M 


WORD 


ON 


MODULE 


OFF 


80 


80 


V 


72 




M 


OFF 


OFF 


NAMES 


OFF 


255 


255 


V 


T 




M 


OFF 


ON 


NETLOG 


OFF 


255 


255 


V 


T 




M 


OFF 


ON 


NOTE 


OFF 


132 


132 


V 


T 




M 


WORD 


ON 


NOTEBOOK 


OFF 


132 


132 


V 


T 




M 


WORD 


ON 


PASCAL 


OFF 


72 


72 


V 


T 




M 


OFF 


ON 


PLI 


ON 


72 


80 


F 


T 




U 


OFF 


ON 


PLIOPT 


ON 


72 


80 


F 


T 




U 


OFF 


ON 


SCRIPT 


OFF 


132 


132 


V 


T 




M 


WORD 


CANON 


TEXT 


OFF 


80 


80 


F 


72 




M 


OFF 


OFF 


UPDATE 


ON 


71 


80 


F 


72 




U 


OFF 


ON 


UPDT 


ON 


71 


80 


F 


72 




U 


OFF 


ON 


VSBASIC 


OFF 


80 


80 


F 


T 




U 


OFF 


ON 


VSBDATA 


OFF 


132 


132 


V 


T 




U 


OFF 


ON 


XEDIT 


OFF 


255 


255 


V 


T 




U 


OFF 


ON 


Other 


OFF 


80 


80 


F 


** 




U 


OFF 


ON 



Where VERIFY = T means verify = trunc column and Verify = ** means verify 
= screen size. 
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FILE TYPE 


Tab Settings 


$EXEC 


1 4 7 10 13 16 19 22 25 31 37 43 49 55 79 80 


$XEDIT 


1 4 7 10 13 16 19 22 25 31 37 43 49 55 79 80 


AMSERV 


2 5 10 15 20 25 30 35 40 45 50 55 60 


ASM3705 


1 10 16 30 35 40 45 50 55 60 65 70 


ASSEMBLE 


110 16 30 35 40 45 50 55 60 65 70 


BASDATA 


1 7 10 15 20 25 30 35 40 45 50 55 60 65 70 75 80 85 90 95 100 105 110 115 120 


BASIC 


1 7 10 15 20 25 30 35 40 45 50 55 60 65 70 75 80 85 90 95 100 105 110 115 120 


CNTRL 


1 58 17 2731 


COBOL 


1 8 12 20 28 36 44 68 72 80 


COPY 


1 10 16 30 35 40 45 50 55 60 65 70 


DLCS 


1 4 7 10 13 16 19 22 25 31 37 43 49 55 


DIRECT 


1 5 10 15 20 25 30 35 40 45 50 55 60 65 70 75 


ESERV 


2 5 10 15 20 25 30 35 40 45 50 55 60 


EXEC 


1 4 7 10 13 16 19 22 25 31 37 43 49 55 79 80 


FORTRAN 


1 7 10 15 20 25 30 80 


FREEFORT 


9 15 18 23 28 33 38 81 


GCS 


1 4 7 10 13 16 19 22 25 31 37 43 49 55 79 80 


GROUP 


1 10 16 30 35 40 45 50 55 60 65 70 


JOB 


1 5 10 15 20 25 30 35 40 45 50 55 60 65 70 75 


LISTING 


1 5 10 15 20 25 30 35 40 45 50 55 60 65 70 75 80 85 90 95 100 105 110 115 120 


MACLIB 


1 10 16 30 35 40 45 50 55 60 65 70 


MACRO 


1 10 16 30 35 40 45 50 55 60 65 70 


MEMBER 


1 5 10 15 20 25 30 35 40 45 50 55 60 65 70 75 80 85 90 95 100 105 110 115 120 


MEMO 


1 10 16 30 35 40 45 50 55 60 65 70 


MODULE 


1 5 10 15 20 25 30 35 40 45 50 55 60 65 70 75 80 85 90 95 100 105 110 115 120 


NAMES 


1 5 10 15 20 25 30 35 40 45 50 55 60 65 70 75 80 85 90 95 100 105 110 115 120 


NETLOG 


1 5 10 15 20 25 30 35 40 45 50 55 60 65 70 75 80 85 90 95 100 105 110 115 120 


NOTE 


1 5 10 15 20 25 30 35 40 45 50 55 60 65 70 75 80 85 90 95 100 105 110 115 120 


NOTEBOOK 


1 5 10 15 20 25 30 35 40 45 50 55 60 65 70 75 80 85 90 95 100 105 110 115 120 


PASCAL 


1 5 10 15 20 25 30 35 40 45 50 55 60 65 70 75 


PLI 


2 4 7 10 13 16 19 22 25 31 37 43 49 55 79 80 


PLIOPT 


2 4 7 10 13 16 19 22 25 31 37 43 49 55 79 80 


SCRIPT 


1 5 10 15 20 25 30 35 40 45 50 55 60 65 70 75 80 85 90 95 100 105 110 115 120 


TEXT 


1 5 10 15 20 25 30 35 40 45 50 55 60 65 70 75 80 


UPDATE 


1 10 16 30 35 40 45 50 55 60 65 70 


UPDT 


1 10 16 30 35 40 45 50 55 60 65 70 


VSBASIC 


7 10 15 20 25 30 80 


VSBDATA 


1 5 10 15 20 25 30 35 40 45 50 55 60 65 70 75 80 85 90 95 100 105 110 115 120 


XEDIT 


1 4 7 10 13 16 19 22 25 31 37 43 49 55 79 80 


Other 


1 5 10 15 20 25 30 35 40 45 50 55 60 65 70 75 80 85 90 95 100 105 110 115 120 
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Appendix B. Effects of Selective Line Editing Subcommands 

SELECTIVE LINE EDITING - A GENERAL DESCRIPTION 

Selective line editing can be used in a macro to control both the action of the editor 
and the screen display. It consists of four subcommands: SET SELECT, SET 
DISPLAY, SET SCOPE, and SET SHADOW, which work together in the following 
manner. You can use SET SELECT to assign a "selection level," or value, to one or 
more Unes in a file. Lines can be logically grouped by assigning them the same 
selection level. SET DISPLAY may be used in conjunction with SET SELECT to 
display those lines which have the same selection level. SET SCOPE defines the set 
of lines that the editor can act upon. SCOPE DISPLAY is the initial setting and, as 
such, restricts editor action to only those lines that are defined by SET DISPLAY. 
By default, SET SHADOW displays a notice indicating how many lines are not 
being displayed in the physical position of the excluded Unes in the file. If SET 
SHADOW is "OFF," only those hnes defined by SET DISPLAY will appear on the 
screen, with no shadow lines to indicate where lines are not being displayed. 

Some subcommands automatically cause specific "SETs" to be made within the file 
when they are invoked from a selective line editing environment. This appendix 
addresses those "automatic" sets, in addition to differences in subcommand 
operation when invoked from different selective line editing environments. 

AUTOMATIC SELECTION LEVEL ASSIGNMENT: The initial selection level for all 
lines in a file is 0. When new lines are being added to a file, they are automatically 
assigned a selection level. That selection level is dependent upon the subcommand 
that was used to add the new Unes. Below is a Ust of those subcommands and how 
each affects selection level assignment. 

ADD New Une has selection level of nl (the first selection level defined for 

inclusion in the screen display) of SET DISPLAY nl n2. (Also applies 
to A/I prefix subcommands). 

COPY Copied Unes have the same selection level(s) as they do in their original 

position in the file. (Also applies to C prefix subcommand). 

DUPLICAT DupUcated Unes have the same selection level(s) as they originally had, 
prior to duplication. (Also applies to prefix subcommand). 

GET Lines inserted in the file by the usage of the GET subcommand have 

selection level nl (the first selection level defined for inclusion in the 
screen display) of SET DISPLAY nl n2. 

INPUT New line has selection level of nl (the first selection level defined for 

inclusion in the screen display) of SET DISPLAY nl n2. 

JOIN Joined Unes have the same selection level as the original set of Unes with 

which they are being joined. 

MERGE Merged lines have the same selection level as the Unes with which they 

are being merged. 

MOVE Moved Unes retain their original selection level(s). (Also applies to M 

prefix subcommand). 

RECOVER Recovered Une has a selection level of nl (the first selection level 

defined for inclusion in the screen display) of SET DISPLAY nl n2. 
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REPLACE When entering the REPLACE subcommand with text, the new Une has 
the same selection level as the line it is replacing. Entering the 
REPLACE subcommand without text will delete the current Une and 
cause you to enter input mode. The selection level of the new lines 
inserted while you are in input mode is nl of the SET DISPLAY nl n2. 

SET SPILL New Une(s) that is created as a result of being spilled has selection level 
nl (the first selection level defined for inclusion in the screen display) of 
SET DISPLAY nl n2. 

SPLIT New hne(s) created by a split have the same selection level(s) as the 

original Une. 

HOW THE SCOPE SETTING AFFECTS THE ACTION OF SOME SUBCOMMANDS: 

The action of some subcommands is also dependent upon the SCOPE setting. These 
subcommands can be divided into two functional groups: 

1 . Those which perform target processing or searches and 

2. Those which perform operations on file Unes. 

Target Processing and Searches: Target searches are performed only on Unes 
within the current scope. If SCOPE DISPLAY has been set, the targpt search only 
considers and looks at displayed Unes. This is true for all types of targets: absolute 
line numbers, a relative displacement from the current line, a line name, a simple 
string expression, or a complex string expression. Line movement by use of targets 
is done as if lines outside the scope had been removed from the file. For example, 
NEXT or + 1 may go from line 20 to line 40 if lines 21 to 39 are outside the display 
range. If SCOPE ALL has been set, the editor acts on the entire file. 



Subcommand 


Scope Display 


Scope All 


BOTTOM 


The last line of the scope becomes 
the current Une. (Line must be 
displayed.) 


The last Une of the file becomes the 
current line. (Line may or may not 
be displayed.) 


CLOCATE /string/ 


String must be in the scope to be 
located. (Line containing string 
must be displayed.) 


String must be in the file to be 
located. (Line containing string may 
or may not be displayed.) 


DOWN, NEXT 


Next line in the scope becomes the 
current Une. (Line must be 
displayed.) 


Next line in the file becomes the 
current line. (Line may or may not 
be displayed.) 


FIND or FINDUP 


Searches forward or backward in the 
file for the first line within the scope 
that starts with the text specified in 
the operand. (Line must be 
displayed.) 


Searches forward or backward in the 
file for the first line that starts with 
the text specified in the operand. 
(Line may or may not be displayed.) 


LOCATE +1 


Next line in the scope is located. 
(Line must be displayed.) 


Next line in the file is located. (Line 
may or may not be displayed.) 


NFIND or NFINDUP 


Searches forward or backward in the 
file for the first line within the scope 
that does not start with the text 
specified in the operand. (Line must 
be displayed.) 


Searches forward or backward in the 
file for the first line that does not 
start with the text specified in the 
operand. (Line may or may not be 
displayed.) 
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Subcommand 


Scope Display 


Scope All 


UP 


Previous line in the scope becomes 
the current Une. (Line must be 
displayed.) 


Previous line in the file becomes the 
current Une. (Line may or may not 
be displayed.) 



This concept applies for every subcommand that takes a target except SET RANGE, 
SORT, and the macro ALL, which are special cases that operate outside of the 
SCOPE. They execute as if SCOPE ALL were in effect, no matter what the SCOPE 
setting is. For example: 



Subcommand 


Scope Display 


Scope All 


SET RANGE :1 :20 


RANGE is set from line 1 to 20 
whether 1 and 20 are in the scope 
or not. (Lines 1 and 20 may not 
be displayed.) 


Same as SCOPE DISPLAY 


SORT /NY/ 1 5 


Columns 1 to 5 are sorted into 
ascending sequence for all lines in 
the file from the current line up to 
but not including the line 
containing the string NY. (Lines 
may or may not be displayed.) 


Same as SCOPE DISPLAY 


ALL /SET/ 


All lines in the file with string 
SET are selected for editing (Lines 
may or may not be displayed.) 


Same as SCOPE DISPLAY 



Operations: The operation of many subcommands is affected by the SCOPE setting 
that has been defined. A few examples follow to illustrate how some of those 
operations are affected. 



Subcommand 


Scope Display 


Scope All 


CHANGE/Record/Line/* 


"Record" is changed to "Line" in 
all lines in the scope from the 
current line until the end of the 
file. (Lines must be displayed.) 


"Record" is changed to "Line" in 
all lines in the file from the 
current line until the end of the 
file. (Lines may or may not be 
displayed.) 


MOVE 3 /DATA/ 


Three lines that are in the scope 
starting with the current line are 
moved after the Une containing 
the string DATA. (The three lines 
must be displayed.) 


Three lines that are in the file 
starting with the current line are 
moved after the line containing the 
string DATA. (The three Unes 
may or may not be displayed.) 


UPPERCAS 20 


20 Unes starting from the current 
line that are in the scope are 
translated to uppercase. (Lines 
must be displayed.) 


20 Unes from the current Une that 
are in the file are translated to 
uppercase. (Lines may or may not 
be displayed.) 



This concept applies for every subconmiand that performs an operation including 
prefix subcommands and macros, except SORT and the macro ALL. (See previous 
description.) 
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ISSUING PREFIX SUBCOMMANDS AND MACROS FROM A SHADOW LINE: If 

SCOPE DISPLAY is in effect (the default), all prefix subcommands and macros are 
invalid if entered on a shadow line with the following exceptions: 



Subcommand 


Scope Display 


Scope All 


A 


Line is added after the last line 
represented by the shadow line. 


Line is added after the first Une 
represented by the shadow Une. 


F 


Line(s) will be moved or copied after 
the last Une represented by the 
shadow Une. 


Line(s) will be moved or copied after 
the first line represented by the 
shadow Une. 


I 


Line is inserted after the last line 
represented by the shadow line. 


Line is inserted after the first Une 
represented by the shadow line. 


P 


Line(s) will be moved or copied 
before the first Une represented by 
the shadow Une. 


Line(s) will be moved or copied 
before the first line represented by the 
shadow line. 


S 


Line(s) will be redisplayed. 


Line(s) will be redisplayed. 



If SCOPE ALL is in effect, all prefix subcommands and macros can be entered on a 
shadow Une except SI. The operation requested is performed on file Unes whether 
they are displayed or not. For example, entering D3 on a shadow line will delete the 
next three lines in the file whether these lines are represented by a shadow Une or are 
displayed. 

For prefix subcommands and macros with block operations, shadow lines (excluded 
lines) within the block are handled differently depending on the SCOPE setting. See 
the example below. 

Example: In the foUowing segment of a file, a shadow line faUs within a block 
prefix subcommand entry. 



===== The resort is comprised of 500 acres. 
===== It has a private pond, waterfalls, brooks, and woodlands. 
===== It is just one step away from hiking, swimming, and skating. 
=dd=:= And it is being offered 

===== 1 line(s) not displayed 

=dd== For more information, please call. 



When SCOPE DISPLAY is set, the shadow Une is not affected by the execution of 
the block entry. Please note that the shadow line remains in the file in this instance. 



===== The resort is comprised of 500 acres. 

===== It has a private pond, waterfalls, brooks, and woodlands. 

===== It is just one step away from hiking, swimming, and skating. 

===== 1 line(s) not displayed 
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However, when the same block entry is executed while SCOPE ALL is set, the 
shadow line is affected by the execution of the block entry. 

===== The resort is comprised of 500 acres. 
===== It has a private pond, waterfalls, brooks, and woodlands. 
===== It is just one step away from hiking, swimming, and skating. 
===== * * * End of File * * * 
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Appendix C. CMS Editor (EDIT) IVIigration IVlode 



Usage Notes 



To edit a file in EDIT migration mode, issue the CMS command, EDIT, the same 
way that you would when you normally invoke the CMS editor. The XEDIT editor 
automatically places you in EDIT migration mode, in which you can issue all of the 
EDIT subcommands; you can also issue any XEDIT subcommand that does not 
have the same name as an EDIT subcommand. 

In addition, EDIT migration mode provides full screen editing capabihties, that is, 
you can type over data on any file line that is displayed on the screen. 

If you want to invoke the old CMS editor (instead of XEDIT in EDIT migration 
mode) for a particular file, you can specify "OLD" as an option on the EDIT 
command. For example: 

EDIT fn ft (OLD 

The old CMS editor has not been enhanced for VM/SP and will not be enhanced in 
future releases of VM/SP. Specifically, the CMS editor will not include support for 
new display devices. 



1. The following EDIT subcommands are executed in EDIT migration mode the 
same way they are executed under the CMS editor: 



ALTER 


FNAME 


PROMPT 


STACK 


AUTOSAVE 


FORMAT 


QUIT 


TABSET 


BACKWARD 


FORWARD 


RECFM 


TOP 


BOTTOM 


GETFILE 


RENUM 


TRUNC 


CASE 


IMAGE 


REPEAT 


TYPE 


CHANGE 


INPUT 


REPLACE 


UP 


CMS 


LINEMODE 


RESTORE 


X,Y 


DELETE 


LOCATE 


RETURN 


ZONE 


DOWN 


LONG 


REUSE 


? 


DSTRING 


NEXT 


SAVE 


$xxxx * 


FIND 


OVERLAY 


SERIAL 




FMODE 


PRESERVE 


SHORT 





* When the editor parses input that begins with "$", it interprets the input as an 
EXEC and ignores any IMPCMSCP or MACRO settings. 

2. The following EDIT subcommands are executed slightly differently in EDIT 
migration mode: 

SCROLL/SCROLLUP 

Under the CMS editor, these subcommands scroll the file one full 
screen. In EDIT migration mode, they scroll the screen one full screen 
minus one line, so that the last (or first) line on the previous screen 
appears on the new display. 

VERIFY 

Under the CMS editor, the operands ON and OFF are ignored if the 
VERIFY subcommand is issued from a display terminal. In EDIT 
migration mode, ON and OFF are handled the same way on a display 
as they are on a typewriter terminal. 

3. Any XEDIT subcommand that does not appear in the list above can be issued in 
EDIT migration mode. 
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4. In EDIT migration mode, you can issue the XEDIT subcommand HELP to 
request information on EDIT subcommands only. You cannot request a HELP 
display for XEDIT subcommands. 

5. In the EDIT command, the default file mode is "*" instead of "Al." 

6. The screen differs from the CMS editor's screen in the following ways: 

a. The file identification line (the first Une of the screen) contains the following 
additional information: the truncation column (Trunc = nn); the current 
number of lines in the file (Size = nn); the file line number of the current line 
(Line = nn); the column number of the current column (Col = nn), and the 
alteration count (Alt = nn). 

b. The command hne contains an arrow (= = = = >)■ 

c. The lower right hand corner displays the status of the editing session, for 
example, input mode or edit mode. 

7. When you issue EDIT, the Unend character default is "ON". When editing files 
which contain characters the editor recognizes as linend characters, you may 
want to SET LINEND OFF or change it to another character. See SET 
LINEND subcommand in this manual. In Une mode, a CP TERMINAL 
LINEND OFF must also be issued to cancel the effect of the default linend 
character. See the TERMINAL command in the VM/SP CP General User 
Command Reference. 

Notes for Macro Writers 

When an EDIT command is issued from an EXEC file, the CMS editor is invoked. 
To invoke EDIT migration mode, you must issue the following statement in your 
EXEC file: 

EXEC EDIT ... 
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Appendix D. Migrating from EDIT to XEDIT 



Table 2 lists the EDIT subcommands and their XEDIT counterparts. 

Many of the subcommand names are the same; however, the operands are usually 
different. Refer to the subcommand descriptions in this book for complete 
information on using the XEDIT subcommands. 



Table 2 (Page 1 of 2). EDIT Migration Chart 


If you used 
this EDIT 
command: 


Now use this XEDIT command: 


ALTER 

AUTOSAVE 

BACKWARD 

BOTTOM 

CASE 


ALTER 

SET AUTOSAVE 

UP 

BOTTOM 

SET CASE 


CHANGE 

CMS 

DELETE 

DOWN 

DSTRING 


CHANGE (G not supported) 

CMS 

DELETE 

DOWN 

DELETE 


FILE 

FMODE 

FNAME 

FORMAT 

FORWARD 


FILE 

SET FMODE 

SET FNAME 

SET TERMINAL 

DOWN 


GETFILE 

IMAGE 

INPUT 

LINEMODE 

LOCATE 


GET 

SET IMAGE 

INPUT 

Not supported 

LOCATE 


LONG 

NEXT 

OVERLAY 

PRESERVE 

PROMPT 


SET MSGMODE ON LONG 

NEXT 

OVERLAY 

PRESERVE 

Not supported 


QUIT 

RECFM 

RENUM 

REPEAT 

REPLACE 


QUIT 

SET RECFM 

RENUM 

REPEAT (repeat any previous subcommands) 

REPLACE 
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Table 2 (Page 2 of 2). EDIT Migration Chart 


If you used 
this EDIT 
command: 


Now use this XEDIT command: 


RESTORE 
RETURN 
REUSE (=) 
SAVE 
SCROLL 


RESTORE 
RETURN 

SAVE 
FORWARD 


SCROLLUP 

SERIAL 

SHORT 

STACK 

TABSET 


BACKWARD 

SET SERIAL 

SET MSGMODE ON SHORT 

STACK (STACK string not supported) 

SET TABS 


TOP 

TRUNC 

TYPE 

UP 

VERIFY 


TOP 

SET TRUNC 

TYPE (second operand not supported) 

UP 

SET VERIFY 


X or Y 

ZONE 
? 

nnnn 
$DUP 
$MOVE 


Can be done via SET SYNONYM and/or REPEAT 

SET ZONE 

? 

:nnnn (nnnn is equivalent to +nnnn) 

DUPLICATE 

MOVE 
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Appendix E. Optimizing l\/iacros 



The XEDIT macro VMFOPT can be used to improve the performance of XEDIT 
macros. Conversely, a macro optimized by the VMFOPT macro can be restored to 
its original form by executing the VMFDEOPT macro. 

The following XEDIT macros have already been optimized: 

CMS ED IT 

VMFOPT 

VMFDEOPT 

These macros contain the following statements, which are inserted during the 
optimizing process; they indicate that if a macro needs to be changed, it must first be 
deoptimized (by using VMFDEOPT) and then reoptimized (by using VMFOPT). 



^OPTIMIZED AT 


14:13:12 ON 80/01/29 










*% 


NOT 


I C E: 










*% 


THIS MACRO [ 


^AS BEEN OPTIMIZED USING 


THE 


XEDIT MACRO - 


VMFOPT 


*% 


DE-OPTIMIZE 


THIS MACRO BEFORE MAKING ANY 


CHANGES 


USING 


- VMFDEOPT 



Note: VMFOPT and VMFDEOPT will execute satisfactorily only on the macros 
hsted above. 
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The VMFOPT Macro 

Format 



VMFOPT 



The VMFOPT macro improves performance in the following ways: 

• It replaces labels with line numbers in EXEC 2 &GOTO statements. In other 
words, an EXEC 2 statement "&GOTO - LABEL" is replaced by an equivalent 
statement, "&GOTO Hnenumber - LABEL". For example, the following EXEC 
2 statement: 

&GOTO -EXIT 

is replaced by: 

&GOTO 182 -EXIT 

where the label " -EXIT" is on line 182. Notice that the label name (EXIT) is 
kept, so that the macro can be deoptimized, if necessary. 

• It recomputes existing "&GOTO linenumber" statements whose targets may 
have shifted because of extra lines inserted by VMFOPT. 

• It is also able to optimize label variables of the form "&GOTO -&X". Targets 
for label variables can be declared as label constants, using the optimizer control 
command, *%LABELS. This command causes VMFOPT to insert EXEC 2 
statements that set up special variables. The name of these special variables 
contains the unprintable character X ' EO ' to avoid confusion with user-defined 
variables. 

For example: 



Prior to optimizing; 

niABELS -BOTTOM -CANCEL -CASE -CHANGE -CLINE -CMD 

When optimized; 

*%LABELS -BOTTOM -CANCEL -CASE -CHANGE -CLINE -CMD SYN -CMS 
&STACK LIFO 187 194 199 221 265 287 
&READ VARS & -BOTTOM & -CANCEL & -CASE & -CHANGE & -CLINE & -CMD 
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The VMFDEOPT Macro 



Macros optimized by VMFOPT can be restored to their original form by executing 
the VMFDEOPT macro. 



Format 



VMFDEOPT 



After the VMFDEOPT macro is executed, all &GOTO statements are restored to 
their original form, and any extra lines added by VMFOPT (for example, the 
optimization statement) are removed. 

When you wish to change an optimized macro, first deoptimize it using 
VMFDEOPT and then, after the changes are made, reoptimize it using VMFOPT. 
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Appendix F. Using Double-Byte Character Sets 

Many languages have more characters than can be displayed using one-byte codes 
(KANJI, for example). A Double-Byte Character Set (DECS) is used to represent 
these languages. These characters can be displayed on terminals that support 
Double-Byte Character Sets, such as the IBM 5550 Multistation. Each double-byte 
character occupies two columns on the screen. DBCS characters and characters 
from languages with one-byte codes can be mixed within a string. 

Specifying DBCS Characters in a Fiie 

In XEDIT, to distinguish DBCS characters from one-byte EBCDIC characters, 
DBCS strings are enclosed with a shift-out (SO) character and a shift-in (SI) 
character. 

Character Hexadecimal Description 

I X'OE' shift-out (SO) 

i X'OF' shift-in (SI) 



Key to Conventions Used in This Section 

Character Represents a 

e Lowercase EBCDIC character 

E Uppercase EBCDIC character 

E One DBCS character (occupies two columns) 

ABC A DBCS string 



Editing DBCS strings 



In order for you to see DBCS strings and for XEDIT to recognize DBCS strings in a 
file, the ETMODE setting must be ON. 

The initial setting is based on whether the terminal can display double-byte 
characters. If it can, the initial setting is ON; if not, the setting is OFF. 

In order for XEDIT to properly display and manipulate DBCS strings, when 
ETMODE is on, it does the following: 

• Drops contiguous shift-out and shift-in characters after executing a subcommand 
(with a few exceptions) 

• Generates proper pairings of shift-out and shift-in characters after executing a 
subcommand 

• Provides special consideration for shift-out and shift-in when doing a target 
search. 
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Dropping Contiguous Stiift-out and Shift-in Characters 

When you issue a subcommand, XEDIT checks for contiguous shift-out and shift-in 
characters generated by the operation. Contiguous shift-out and shift-in characters 
are deleted and the remainder of the line shifts to the left two bytes, (except with the 
CREPLACE subcommand, which changes these characters to blanks). For example, 
if you were to join lines 10 and 11 at column 12: 

I ... + 1.. .. + ... .2 + 3 + ...A 

00010 eeelAAAi 

00011 IBBBieee 

The result would be: 

I ...+....1....+....2....+....3....+....4.... 
00010 eeelAAABBBIeee 

The contiguous shift-out and shift-in characters were removed. 

Pairing Shift-out and Shift-in Characters 

XEDIT properly pairs shift-out and shift-in characters after executing a 
subcommand. If a subcommand results in the deletion of a shift-out or shift-in 
character, then the appropriate character is inserted so that a DBCS string is always 
between shift-out and shift-in characters. For example, if you were to split lines 10 
and 1 1 at column 1 1 : 

I ...+....1.. ..+....2....+....3....+....^.... 
00010 eeelAAABBBIeee 

The result would be: 

I ...+....1....+.. ..2. ...+... .3. ...+.. ..4.... 

00010 eeelAAAi 

00011 IBBBieee 



Target Searches with Shift-out and Shift-in Characters 

When XEDIT scans a file for a string target, an SO or SI is ignored in the following 
cases: 

• The first character of a string target is an SO. 

• The last character of a string target is an SI. 

• The SO or SI is specified immediately preceding or immediately following: 

- An arbitrary character when ARBCHAR is ON 

- An extended arbitrary character when ETMODE and ETARBCH are ON. 
For example: 

LOCATE /lAi/ willlocate IBABS. 
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The shift-out and shift-in characters of the target are ignored during the search. 

Using XEDIT Subcommands with DBCS 

The following subcommands can be used in extended mode (ETMODE ON). 



Add 


Query 


SET 


PENDing 


ALL 


QUIT 


SET 


PFn 


ALter 


READ 


SET 


Point 


BAckward 


RECover 


SET 


PREfix 


Bottom 


REFRESH 


SET 


RANge 


CANCEL 


RENum 


SET 


RECFm 


CAppend 


REPEat 


SET 


REMOte 


CDelete 


Repl 


lace 


SET 


RESERved 


CFirst 


RESet 


SET 


SCALe 


Change 


RESTore 


SET 


SCOPE 


CInsert 


RGTLEFT 


SET 


SCReen 


CLAst 


Right 


SET 


SELect 


CLocate 


SAVE 


SET 


SERial 


CMS 


SCHANGE 


SET 


SHADOW 


CMSG 


SET 


ALT 


SET 


SIDcode 


COMMAND 


SET 


APL 


SET 


SPAN 


copy 


SET 


ARBchar 


SET 


SPILL 


count 


SET 


AUtosave 


SET 


STAY 


CP 


SET 


BRKkey 


SET 


STReam 


CReplace 


SET 


CASE 


SET 


SYNonym 


CURsor 


SET 


CMDline 


SET 


TABLine 


DELete 


SET 


COLOR 


SET 


TABS 


Down 


SET 


COLPtr 


SET 


TERMinal 


DUPlicat 


SET 


CTLchar 


SET 


TEXT 


EMSG 


SET 


CURLine 


SET 


TOFEOF 


EXTract 


SET 


Display 


SET 


TRANS Lat 


FILE 


SET 


ENTer 


SET 


TRunc 


Find 


SET 


ESCape 


SET 


VARblank 


FINDUp 


SET 


ETARBCH 


SET 


Veri fy 


Forward 


SET 


ETMODE 


SET 


WRap 


GET 


SET 


FILler 


SET 


Zone 


Help 


SET 


FMode 


SET 


= 


Input 


SET 


FName 


SHift 


Join 


SET 


FType 


SI 




LEft 


SET 


FULLread 


SOS 




LOAD 


SET 


HEX 


SPli 


it 


Locate 


SET 


IMage 


SPLTJOIN 


LOWercas 


SET 


IMPcmscp 


STAck 


LPrefix 


SET 


LASTLorc 


STATUS 


MACRO 


SET 


LINENd 


TOP 




MODify 


SET 


LRecl 


TRAr 


isfer 


MOve 


SET MACRO 


Type 


MSG 


SET 


MASK 


Up 




Next 


SET 


MSGLine 


UPPercas 


NFind 


SET 


MSGMode 


Xedi 


it 
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NFINDUp 


SET NONDisp 


PARSE 


SET NULls 


PREServe 


SET NUMber 


PURge 


SET PAn 


PUT, PUTD 


SET PACK 



,xxxx 



Subcommands that Support SET ETMODE 

The following subcommands will return the ETMODE setting. 

EXTRACT 
MODIFY 
QUERY 
STATUS 



Subcommand 

EXTRACT /ETMODE/ 



MODIFY ETMODE 
QUERY ETMODE 
STATUS 



Results 

returns ON or OFF as specified by the SET ETMODE 
subcommand. 

ETMODE. number of variables returned 

.1 ONIOFF 

displays SET ETMODE ON or SET ETMODE OFF on 

the command line. 

displays ON or OFF as defined by the SET ETMODE 
subcommand. 

returns the setting of ETMODE as well as the settings of 
the other SET subcommand options. 



Subcommands that Support SET ETARBCH 

The following subcommands will recognize the ETARBCH setting. 

EXTRACT 
MODIFY 

PRESERVE/RESTORE 
QUERY 



Subcommand 

EXTRACT /ETARBCH/ 



MODIFY ETARBCH 



PRESERVE 



Results 

returns "ON" or "OFF" and the extended arbitrary 
character specified in the SET ETARBCH subcommand. 

ETARBCH . number of variables returned 

.1 ONIOFF 

. 2 extended arbitrary character enclosed by a 

shift-in and a shift-out character 

returns SET ETARBCH ON|OFF character on the 
command Hne. 

saves the ETARBCH setting until a subsequent RESTORE 
subcommand is issued. 
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RESTORE 



QUERY ETARBCH 



restores the ETARBCH setting to the value it had when 
the PRESERVE subcommand was issued. 

displays ON or OFF and the extended arbitrary character 
defined by the SET ETARBCH subcommand. 



XEDIT subcommands with SET ETMODE ON 

The following subcommands are described in this section. 



CAPPEND 



CAppend 


Input 


SET SIDcode 


CDelete 


Join 


SET SPILL 


CFirst 


LEft 


SET SYNonym 


Change 


Locate 


SET TRunc 


CInsert 


LOWercas 


SET Verify 


CLAst 


NFind, NFINDUp 


SET Zone 


CLocate 


PUT, PUTD 


SHift 


CReplace 


Replace 


SPlit 


CURsor 


SET LRecl 


SPLTJOIN 


Find, FINDUp 


SET SERial 


UPPercas 


GET 







When you append a DBCS string to another DBCS string, the shift-in and shift-out 
characters between the two strings are dropped. For example, if you issue 

CAPPEND IBB I 



against the current Une: 



l... + ....1....-f 
00010 eeelAAAAAi 



The result will be: 



<... + ....1.... I 2 

00010 eeelAAAAABBI 
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CDELETE 



When you specify a column target with the CDELETE subcommand, that column is 
checked to see if it is the second byte of a DBCS character. If so, the previous 
column is considered the target. CDELETE will not delete a shift-out or shift-in 
character if it is required to maintain the integrity of the DBCS string. 

For example, if the column pointer is at column 1 and you issue the subcommand: 
CDELETE :8 

against the current Une: 



1 



00010 eeelABCDEi 



The result will be: 



00010 IBCDEI 



CFIRST 



CHANGE 



If you issue CFIRST and the left zone is the second byte of a DBCS character, then 
the column pointer will be repositioned at the left zone plus one. 



When you issue the CHANGE subcommand, DBCS strings can be in the string to 
be changed and in the new string. 



Example: 
Subcommand 
C/IAi/IBl/ will change 

C/i Ale/IB IE/ will change 

will not change 



From 

lAI 

lACCi 
iCCAi 
iCACI 

i Aieeee 
iCAiee 
iCAClee 



To 

IBI 

IBCCI 
iCCBI 
iCBCi 

IBSEeee 
iCBIEe 
ICBCI Ee 



You can specify an extended arbitrary character (with SET ETARBCH) in a DBCS 
string in the same fashion as the arbitrary character (SET ARBCHAR) is used in 
EBCDIC strings to specify that any characters may appear in the matching string in 
the file. Following are examples of using CHANGE with arbitrary and extended 
arbitrary characters. 
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Example: 
Subcommand 

C/e$e/iA¥Ci/ will change 

C/el¥le/iAi$iCi/ will change 

C/e$e/iAI$iCI/ will change 

C/ei¥le/iA¥CI/ will change 

C/iA¥CI/e$e/ will change 

C/i AI$iCl/ei¥ie/ will change 

C/iAi$iCI/e$e/ will change 

C/lA¥CI/ei¥ie/ will change 



From 

elBle 

eEe 

eEi BIEe 

elBIEIBie 

lAIEICi 

lABCi 

lABiEIBCi 



To 

lABCi 

lAIEICI 

lAlEIBIEiCi 

lABIEIBCi 

eEe 

elBie 

elBIEIBie 



lAiEIBIEICI eElBIEe 



When a double-byte character is at or beyond the zone boundary, then it will not be 
changed. 



Example: 
Subcommand 

C/IBI/ICi/ 



From 

will not change ...!<....>., 
lABCDEI 



C/IEI/IKI/ 
C/iCDI/IAAl/ will change 



will not change ...l<. ...>....+ 
lABCDEi 



. . . I< > + 

lABCDEi 



To 

lACCDEI 
lABCDFl 
lABAAEI 



CINSERT 



When a DBCS string is inserted into another DBCS string, the shift-out and shift-in 
characters are not inserted. For example (the column pointer is at column 11): 



<... + 1I ... + 2 + 

00010 eeel1 2 3^SSTieee 



Issuing the subcommand: 

CINSERT I A AS 
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CLAST 



results in: 

<... + ... .11 ... + 2 + 3.... + 4, 

00010 eeei1 23AA^S6Tieee 



When an EBCDIC string is inserted into a DBCS string, appropriate shift-in and 
shift-out characters are inserted to separate the original DBCS string. For example 
(the column pointer is at column 11): 

<.. .+....11...+.. ..2. ...+.. ..3.. ..+... .4.... 
00010 eeei1 2 3^SeTieee 



Issuing the subcommand: 

CINSERT eeee 

results in: 

<...+... .11 ...+... .2. ...+.. ..3. ...+... .4.... 
00010 eeei1 2 3leeeei^SeTleee 

When an DBCS string is inserted into an EBCDIC string, the shift-out and shift-in 
characters are inserted as part of the string. For example (the column pointer is at 
column 11): 

<. .. + 1 I .. . + 2 + 3 + 4 

00010 eeeeeeeeeeeeeeeeeeeeee 

Issuing the subcommand: 

CINSERT lAAl 

results in: 

<...+... .11 ...+.. ..2. ...+.. ..3. ...+....4.... 
00010 eeeeeeeeeelAAieeeeeeeeeeee 



When you use the CLAST subcommand to move the column pointer to the end of 
the zone, a check is made to see if the right zone is at the second byte of a DBCS 
character. If the right zone is the second byte of a DBCS character, the column 
pointer is adjusted to the first byte of the DBCS character (at zone right less one). 



426 VM/SP System Product Editor Command and Macro Reference 



CLOCATE 



CREPLACE 



If the column target is set on the second byte of a DECS character, the column 
pointer is repositioned to the previous column. If the column pointer is at TOL or 
EOL, no adjustment occurs. 



When you replace part of a DBCS string with EBCDIC characters, shift-out and 
shift-in characters are generated to maintain proper pairing of the characters. If the 
second byte of a DBCS character remains after the subcommand executes, it is 
replaced by a blank. For example (the column pointer is at column 11): 



<... + . ...11 ... + 2 + 

00010 eeei1 23^Se'7leee 



A. 



Issuing the subcommand: 



CREPLACE eee 



results in: 



<... + 1 I ... + 2 + 

00010 eeei123leee ITleee 



When you replace one DBCS string with another DBCS string the shift-out and 
shift-in characters are not used as a part of the replacement string. For example (the 
column pointer is at column 1 1): 



<...+... .11 ...+.. ..2....+ 
00010 eeei1 SS^SSTIeee 



Issuing the subcommand: 



CREPLACE lAAl 



results in: 



<.... + 1 I ... + 2.. 

00010 eeei1 SSAASTIeee 



However, when a DBCS string replaces part of an EBCDIC string, the shift-out and 
shift-in characters are included in the replacement string. For example (the column 
pointer is at column 11): 



<... + 11 ... + 2 + 

00010 eeei1 2ieeeeeeei3^leee 
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CURSOR 



Issuing the subcommand: 

CREPLACE lAI 

results in: 

<... + 1I... + 2 + 3 + ^ 

00010 eeei1 2ie| Aleei3^ieee 

The CURSOR subcommand will adjust the cursor position so that the character 
boundaries of DECS characters are respected. For example (the cursor is at column 
1): 

<. . . + 1 I . . . + 2 + 3 + 4 

00010 eeei1 23^SBT8Sleee 

Issuing the subcommand: 

CURSOR FILE 10 20 

results in: 

<... + 1 I .. . + . ...2.... + ... .3.... + 4.... 

00010 eeel1 23^SeT89 



EXTRACT 



FIND, FINDUP 



A shift-out character, as the self-defining delimiter in the EXTRACT subcommand, 
results in a return code of 5. EXTRACT.O will be set to 1 and EXTRACT. 1 will be 
set to the invalid delimiter (the shift-out character). 



The shift-in character is ignored during a search for a DECS string. Issuing: 

FIND 11 21 

would locate either: 

11 21 or II 2 31 
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GET 



INPUT 



JOIN 



If truncation of a DECS string occurs when inserting lines from another file, a 
shift-in character is inserted to close the DBCS string. 



If truncation of a DBCS string occurs when inserting a line, a shift-in character is 
inserted to close the DBCS string. 



When two DBCS strings are joined, the shift-in character from the first string and 
the shift-out character from the second string are dropped. For example (the 
column pointer is at column 24): 

<... + 1 + 2...I + 3 + 4 

00010 eeei1 SS^seTSSIeee 

00011 I A AAA AAA! 



Issuing the subcommand: 

JOIN COLUMN 

results in: 

<... + ....1. ... + ... .2..!. + .. ..3. ... + .. ..4 
00010 eeel1 23^S6TS9AAAAAAAI 



When an EBCDIC string is joined to a DBCS string, a shift-in character is inserted 
at the end of the DBCS string. For example (the column pointer is at column 1 1): 

<... + ll ... + 2 + ....3.... + 4.... 

00010 eeel1 23^SeT89leee 

00011 EEEEEEEEEEEEE 



Issuing the subcommand: 

JOIN COLUMN 

results in: 

<. . . + 1 1 . . . + 2 + 

00010 eeei1 2 3iEEEEEEEEEEEEE 
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LEFT 



LOCATE 



If issuing a LEFT subcommand results in the display of "negative columns", you 
should not type data in these columns or you may lose DBCS strings. 



The abihty to locate a line via a target is one of the editor's most useful functions. 
A target is not only used as the operand of the LOCATE subcommand, but also as 
an operand in many other XEDIT subcommands. The following XEDIT 
subcommands will accept DBCS strings in targets. 

Subcommands that Accept DBCS Strings as Targets: 



ALL 


DELete 


REPEat 


ALter 


DUPlicat 


SET RANge 


CDelete 


EXTract 


SET SELect 


Change 


Locate 


SHift 


CLocate 


LOWercas 


STAck 


copy 


MOve 


Type 


count 


PUT, PUTD 


UPPercas. 



Special Considerations for Targets: When XEDIT scans a file for a string target, 
an SO or SI is ignored in the following cases: 

• The first character of a string target is an SO. 

• The last character of a string target is an SI. 

• The SO or SI is specified immediately preceding or immediately following: 

- An EBCDIC or double-byte blank when VARBLANK is ON 

- An arbitrary character when ARBCHAR is ON 

- An extended arbitrary character when ETMODE and ETARBCH are ON. 

SET CASE 

The IGNORE and RESPECT settings of the SET CASE subcommand have 
no effect when searching for a DBCS string, because there are no 
lowercase/uppercase pairs for double-byte characters. For example: 

SET CASE M IGNORE 
/elale/ 

will locate: 

EialE 

It will not locate: 

EIAIE 
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SET VARBLANK 

You can use the SET VARBLANK ON or OFF subcommand to control 
whether the number of blank characters is significant when searching for a 
string. For example: 

SET VARBLANK ON 
/e lAl/ 



would locate in the text either of the following: 

e I I lAI 
el I i Al 

SET SPAN 

DBCS strings at the end of a line and at the beginning of the next line are 
treated as one string when SET SPAN ON is specified. The shift-in 
character at the end of the first line and the shift-out character at the 
beginning of the second Une are ignored. If SET SPAN ON BLANK is 
specified, then one double-byte blank is inserted between the first and the 
second string. 



Example: 

Command Target 

SET SPAN ON NOBLANK 2 /lABi/ 



Lines in a File 

00010 11 Ai 

00011 IB 11 



/I A Bl/ 00010 11 Ai 
00011 IB II 



Match / No Match 
Match 

No Match 



SET SPAN ON BLANK 2 



/lABI/ 



00010 11 AI 

00011 IB 11 



No Match 



/I A Bi/ 



00010 
00011 



II AI 
IB1I 



Match 



SET ETARBCH 

You can specify an extended arbitrary character (with SET ETARBCH) in a 
DBCS string in the same fashion as the arbitrary character (SET 
ARBCHAR) is used in EBCDIC strings to specify that any characters may 
appear in the matching string in the file. For example: 

SET ETARBCH ON 
/iA¥AI/ 
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would locate in the text any of the following: 

iOAOAOl 

lAleeelAi 

lAieiOielAi 



SET ZONE 

When a double-byte character is at or beyond the zone boundary, then it 
will not be located. For example: 

/i2i/ will not locate ...l< > + 

/iSi/ will not locate ...!<....>.... + .... 

11 23^sei 



/isl 



/i2l/ will locate 



will locate 



.. I<+ 1>. . . + 

11 23^SSi 

. . I<+ 1>. . . + 

11 23^sei 



LOWERCAS 



NFIND, NFINDUP 



PUT, PUTD 



REPLACE 



When you issue the LOWERCAS subcommand, DECS strings are excluded from 
translation. Double-byte characters have no lowercase or uppercase pairs. 



The shift-in character is ignored during a search for a DBCS string. Issuing: 

FIND lABI 

would locate either: 

lABI or lABCi 



If you use PUT or PUTD to append data to a fixed format file, DBCS strings may 
be truncated. You will receive a message warning you that DBCS strings may have 
been lost due to truncation. 



If a DBCS string is truncated when a Une is inserted, a shift-in character is inserted 
to close the DBCS string. 
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SET LRECL 



SET SERIAL 



SET SIDCODE 



SET SPILL 



SET SYNONYM 



If you use SET LRECL to shorten the logical record length of a file being edited, 
you will receive a message warning you that DBCS strings may be lost when the file 
is saved or filed. 



If you specify a serial string that is longer than eight characters, only the first eight 
characters are recognized by XEDIT. When ETMODE is ON and the eighth 
character of the serial string falls within a DBCS string, the editor adjusts the serial 
string to maintain the integrity of the DBCS string. For example, if you specify the 
serial string: 

abi1 2 31 



XEDIT will recognize it as the following: 

abi 1 21 



If you specify a sidcode string that is longer than eight characters, only the first eight 
characters are recognized by XEDIT. When ETMODE is ON and the eighth 
character of the sidcode string falls within a DBCS string, the editor adjusts the 
sidcode string to maintain the integrity of the DBCS string. For example, if you 
specify the sidcode string: 

abi 12 31 



XEDIT will recognize it as the following: 

abi 1 21 



When spilling occurs within a DBCS string, a shift-in character is inserted at the end 
of the first line and a shift-out character is inserted at the front of the remaining 
string that is spilled. 



When ETMODE is ON, a synonym name may consist of single-byte characters, 
double-byte characters, or a combination of single-byte and double-byte characters. 
However, an abbreviation of a synonym name that includes a DBCS string, must use 
the complete DBCS string contained in the synonym. For example, the following 
synonym: 

ai1 2 lb 



can be abbreviated as: 



a or abi 1 21 
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SET TRUNC 



but cannot be abbreviated as: 

ai1l 



If you specify a synonym name that is longer than eight characters, only the first 
eight characters are recognized by XEDIT. When ETMODE is ON and the eighth 
character of the synonym name falls within a DBCS string, the editor adjusts the 
synonym name to maintain the integrity of the DBCS string. For example, if you 
specify the synonym: 

abl1 2 31 



XEDIT will recognize it as the following: 

abi 1 21 



Certain XEDIT subcommands insert characters in a file line shifting existing data to 
the right. If a DBCS string is shifted beyond the truncation column (defined by SET 
TRUNC), a shift-in character is generated to maintain the proper pairing of the 
characters. For example, issuing the subcommands: 

SET TRUNC 15 
CLOCATE 'A 



on the following string: 

<.. 1 + 1 > 

00010 eeelABCDI 



Then, issuing the subcommand: 
CINSERT eeeee 

results in: 

<.. I + ....1... .>.... 
00010 eeeeeeeelABI 



The last DBCS character prior to the truncation column is replaced by a shift-in 
character and a blank. 

Other XEDIT subcommands shorten the length of the file line and insert blanks at 
the truncation column. If the truncation column falls within a DBCS string, then 
blanks are inserted after the shift-in that follows the truncation column. The 
CDELETE, CREPLACE, CHANGE, and SHIFT subcommands treat the TRUNC 
setting in this manner. 
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SET VERIFY 



For example, issuing the subcommands: 

ZONE 11 ^ 
SET TRUNC 20 
CLOCATE :17 



so that the truncation column falls within a DBCS string: 

+ 1<. .. + .!..> + 3 + 4 

000 1 eeeeeeeeeeeeel A B C DIeeeeeeeeeee 

Then, issuing the subcommand: 

CDELETE 2 

results in: 

+ 1<. .. + .!..>.... + 3 + . . . A. . . . 

00010 eeeeeeeeeeeeelACDI eeeeeeeeeee 

The line shifted starting at the shift-in character instead of the truncation column 
(column 20 in this example). 

When ETMODE is OFF, you can issue SET VERIFY to display multiple column 
pairs. Then, if you issue SET ETMODE ON, only the first pair of verify columns 
continues to be displayed. However, when ETMODE is ON and you issue SET 
VERIFY with multiple column pairs, you will get an error message. 

For example, when ETMODE is OFF and if you issue the subcommand: 
V 1 20 40 50 

columns 1 through 20 and 40 through 50 are displayed. 

Then, if you issue: 
SET ETMODE ON 

only columns 1 through 20 continue to be displayed. 

When ETMODE is ON and the column(s) specified by SET VERIFY falls within a 
DBCS string, overtyping to change DBCS characters to EBCDIC characters on the 
first or last column may change the original character that does not appear on the 
screen. For example: 

00010 eeeeeeeeeeeeel ABC Dieeeeeeeeeee 

.... + 1 + 2 + ....3 + 4 
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SET ZONE 



issuing the following: 

SET VERIFY 15 

results in: 

00010 IBCDIeeeeeeeeeee 

+ ....2. ...+•... .3.... + ....^.... 

If you overtype the line as follows: 

00010 a iCDieeeeeeeeeee 

+ 2 + 3 + 4 

then you will have changed the first two double-byte characters: 

00010 eeeeeeeeeeeeelia iCDieeeeeeeeeee 

I. ..+....1.. ..+... .2. ...+.. ..3....+....^... 



Certain XEDIT subcommands ignore data outside the left and/or right zone (defined 
by SET ZONE). If the zone column falls within a DBCS string, then the 
subcommand executes in the entire DBCS string up to and including the shift-in or 
shift-out character. The CDELETE and SHIFT subcommands treat the ZONE 
settings in this manner. If the left zone falls within a DBCS string, then the shift-out 
character is treated as the left zone. If the right zone falls within a DBCS string, 
then the shift-in character is treated as the right zone. For example, issuing the 
subcommands: 

SET ZONE 11 20 
CLOCATE :17 



so that a zone column falls within a DBCS string: 

+ 1<. . . + . I . .> + 3. . . 

00010 eeelABCDIeeeeeeeeeee 

Then, issuing the subcommand: 

SHIFT RIGHT 1 

results in: 

+ 1<. . . + . i . .> + 3. . . 

00010 eee lABCDIeeeeeeeeeee 



436 VM/SP System Product Editor Command and Macro Reference 



SHIFT 



The line shifted starting at the shift-out character instead of the left zone (column 1 1 
in this example). 



When shifting data beyond the file boundary (left of zone left or right of the 
truncation column), shift-out and shift-in characters are generated to maintain 
proper pairing of the characters. For example (the column pointer is at column 4): 



<.. 1 + 1 + 2 + 3 + 

00010 eeel1 SS^SSTS^Ieee 



A. 



Then issuing the subcommand: 

SHIFT LEFT 5 

results in: 



<..l+....1.. ..+... .2....+, 
00010 11 SS^sevsgieee 



For another example (column pointer is at column 4, truncation column is at 
column 25): 



<.. I + ... .1 + ....2 >....3 + 4. 

00010 eeel1 23^SeV89i 



Then issuing the subcommand: 

SHIFT RIGHT 5 

results in: 



00010 



+ 1 + ....2 >, 

eeei1 23^SeTI 



SPLIT 



In this example the last DBCS character prior to the truncation column is replaced 
by a shift-in character and a blank. 



When you spUt a DBCS string, a shift-in character is inserted at the end of the 
original Une and a shift-out character is inserted at the first column of the new Une. 
For example (column pointer is at column 11): 



<... + ... .11 ... + .. ..2. ...>.. ..3. ... + .. ..4 
00010 eeelABCDKFGHIIee 
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and you issue the subcommand: 

SPLIT COLUMN 

the result is: 

00010 eeelABCi 
<...+... .11... +....2 

00011 IDKFGHIIee 



When the split places all the DBCS characters on a new line the shift-out character 
is deleted from the original Une and inserted at the beginning of the new line. For 
example (column pointer is at column 5): 



<...! ....1.... + ....2....>. 
00010 eeelABCDKFGHIiee 



When you issue the subcommand: 

SPLIT COLUMN 

the result is: 



00010 eee 

<...! ....1 + 2....> 

00011 lABCDEFGHIiee 



SPLTJOIN 



UPPERCAS 



When you spUt a DBCS string, a shift-in character is inserted at the end of the 
original hne and a shift-out character is inserted at the first column of the new line. 

When two DBCS strings are joined, the shift-in character from the first string and 
the shift-out character from the second string is dropped. When an EBCDIC string 
is joined to a DBCS string, a shift-in character is inserted at the end of the DBCS 
string. For examples of splitting and joining lines, refer to the descriptions of SPLIT 
and JOIN in this section. 



When you issue the UPPERCAS subcommand, DBCS strings are excluded from 
translation. Double-byte characters have no lowercase or uppercase pairs. 



Error Message 580E 

When ETMODE is ON the following error message may be issued from any XEDIT 
subconmiand or macro: 

580E Invalid string: [Shift-out (SO) is not a valid 
delimiter | Unmatched shift-out (SO) and shift-in 
(SI) I Odd number of characters between SO and 
SI I Invalid double-byte character (s)].,RC=5 
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Restrictions for DBCS 

1 . On terminals without DBCS character support, such as a 3277, DBCS data will 
not be displayed correctly. 

2. The XEDIT sort algorithm does not apply to DBCS codes. 

3. A shift-out character (X'OE') may not be used as a self-defining delimiter. For 
example: 

LOCATE lAI 

is not valid. You must specify a delimiter such as a slash (/). For example: 

LOCATE /lAI/ 

is vaUd. 

4. DBCS strings cannot be specified as a file name, file type, or a file mode because 
of restrictions in the CMS file system. 

5. XEDIT does not allow DBCS strings to span lines in a file. The DBCS string 
must be contained in a single Une so that shift-out and shift-in pairs are 
maintained on each line in the file. Consider this when editing a PL/I source 
statement. 

6. Data stacked by the STACK, READ, and TRANSFER subcommands may be 
truncated because of the CMS stack limitation of 255 characters. When you 
write macros, keep in mind that the data being stacked will be truncated if it 
exceeds 255 characters. 

7. The following subcommands are not allowed in extended mode (SET ETMODE 
ON). You are able to execute these subcommands with SET ETMODE OFF. 
However, DBCS strings are treated as EBCDIC data and you may get 
unpredictable results with respect to DBCS data. 



COMPress 


HEXType 


POWeri np 


COVerl ay 


MErge 


SORT 


EXPand 


Overlay 





DBCS Strings 



8. When SET ETMODE is on, XEDIT does not scan for control characters 
(defined by SET CTLCHAR) within a DBCS string. 

9. When a DBCS string is specified in a PARSE subcommand, XEDIT stops 
searching for the self-defining delimiter within a DBCS string. 



Before XEDIT displays any data or accepts any operands, it verifies that the DBCS 
string is valid. A valid DBCS string has the following characteristics. 

1. All DBCS strings must be preceded by a shift-out character and followed, by a 
shift-in character.. 

2. The length of the string must be even. 
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3. The hex code for a DBCS character must be within the following range: 

first byte X'41' - X'FE' 
second byte X'41' - X'FE' 

X'4040' (DBCS blank) 

X'0000' (DBCS null) 

If any of the above conditions are not met when using DBCS strings with an XEDIT 
subcommand, then an error message is issued. 

When you are displaying data, if any invaUd codes are found, then the DBCS 
character is replaced with a DBCS NONDISP character (X'427F '). Invahd DBCS 
strings will be displayed as EBCDIC data. The shift-out and shift-in characters will 
be replaced with a double quote (or the character defined by SET NONDISP) and 
the remainder of the string will be displayed as EBCDIC. 
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Appendix G. XEDIT Virtual Screens and Windows 



General Description 

When working on a display terminal, XEDIT always uses a virtual screen and 
window. The window and virtual screen have the same name. The name depends on 
whether you specify the WINDOW option on the XEDIT command. If you choose 
the window option, XEDIT uses the name specified. If no WINDOW option is 
specified, XEDIT uses "XEDIT" for the virtual screen and window name. 

When editing a file, XEDIT checks to see if the specified virtual screen and window 
exist. If both do not exist, XEDIT attempts to make the window and virtual screen 
the same size whenever possible. However, windows cannot be larger than the 
physical screen, and the virtual screen used by XEDIT must have at least 5 lines and 
20 columns. XEDIT handles virtual screen and window setup as follows: 

1 . If neither the window nor the virtual screen exist, XEDIT creates both using the 
dimensions of the physical screen. 

2. If the virtual screen exists and has at least 5 Unes and 20 columns, and the 
window does not exist, XEDIT will define the window to be the same size as the 
virtual screen. If the virtual screen is smaller than 5 lines by 20 columns, an 
error message will be given. If the virtual screen is larger than the physical 
screen, XEDIT adjusts either the lines or columns or both so that the window is 
not larger than the physical screen (each dimension is adjusted independently). 

3. If the window exists but the virtual screen doesn't, the virtual screen will be 
defined using the window size, if the window is at least 5 Unes by 20 columns. If 
the window is smaller than 5 hues by 20 columns, XEDIT adjusts either the lines 
or columns or both to match the corresponding dimension(s) of the physical 
screen (each dimension is adjusted independently). 

The following table summarizes these situations: 

On input to XEDIT: 



Table 3 (Page 1 of 2). How XEDIT Defines Virtual Screens and Windows 


Virtual Screen 


Window 


XEDIT Action 


Does not exist 


Does not exist 


Virtual screen and window defined with the same dimensions as 
the physical screen. 


Exists 


Does not exist 


Window defined with the same dimensions of the virtual screen 
unless the virtual screen is larger than the physical screen. If 
the virtual screen is larger, then the physical screen size is used 
to define the window. If the virtual screen is smaller than 5 
lines and 20 columns, an error message will be issued. 


Does not exist 


Exists 


Virtual screen defined with the same dimensions of the window 
unless the window is smaller than 5 lines and 20 columns. If the 
window is smaller in either dimension or both, XEDIT uses the 
corresponding dimension(s) of the physical screen to define the 
virtual screen. 
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Table 3 (Page 2 of 2). How XEDIT Defines Virtual Screens and Windows 


Virtual Screen 


Window 


XEDIT Action 


Exists 


Exists 


Virtual screen and window will be used as long as the virtual 
screen has at least 5 Unes and 20 columns. If not, error message 
will be issued. 



The following examples illustrate the conditions described in the above table. 

• Example 1: 

A virtual screen has 24 lines and 80 columns. A window is not defined. Your 
terminal has a physical screen with 32 lines and 80 columns. The window will be 
defined with 24 Unes and 80 columns. 

• Example 2: 

A virtual screen has 100 Unes and 200 columns. A window is not defined. Your 
terminal has a physical screen with 24 lines and 80 columns. The window will be 
defined with 24 Unes and 80 columns. 

• Example 3: 

A window has 20 lines and 60 columns. A virtual screen is not defined. Your 
terminal has a physical screen with 32 lines and 80 columns. The virtual screen 
will be defined with 20 Unes and 60 columns. 

• Example 4: 

A virtual screen has 24 lines and 200 columns. A window is not defined. Your 
terminal has a physical screen with 32 lines and 80 columns. The window will 
be defined with 24 Unes and 80 columns. 

Default Options for the XEDIT Window 

In the default situation, that is, when XEDIT defines the window for you, XEDIT 
uses the following window options: 

FIXED 

NOBOR 

NOPOP 

USER 

NOTOP 

See the VM/SP CMS User's Guide for a description of these options. 

Full-Screen CMS and the SHOW WINDOW CMSOUT Command 

XEDIT win issue the SHOW WINDOW CMSOUT command at various times. If 
full-screen CMS is ON before XEDIT writes to the screen, SHOW WINDOW 
CMSOUT will be issued followed by SHOW WINDOW XEDIT or a SHOW for the 
particular window that has been set up to display the file. 

When you return to the XEDIT environment from CMS subset mode, the CMSOUT 
window will be shown, followed by the window set up to display the file. 

If you are already in XEDIT and you set full-screen CMS ON, the CMSOUT 
window will be shown if the CMSOUT window has never been shown in this 
XEDIT session and a CMS command is issued, or if an XEDIT message is issued 
that cannot fit into the XEDIT message area. 
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Entering XEDIT from Full-Screen CMS 

Special Considerations: If you enter XEDIT when full-screen CMS is ON and you 
then run an application or an exec that issues a prompt and causes a VM READ 
status, the CMSOUT window will be displayed with a command line. At the 
command line, type in your response and press the ENTER key. When the exec 
terminates, the CMSOUT window will be returned to its original state and will be 
displayed without a command line the next time it is displayed on the screen. 

If you enter XEDIT when full-screen CMS is ON and you then run an application 
or an exec that does not issue a prompt but does cause a VM READ status, the WM 
window will be displayed and the following message will be issued: 

Active window overlaid; enter a windowing command or press a PF key 

In this situation, exit from the WM window; you will be placed in full-screen CMS 
and the status line will prompt you: 

Enter your response in vscreen CMS 

Enter your response and press the ENTER key. You will again be returned to the 
WM window and will receive this message: 

Active window overlaid; enter a windowing command or press a PF key 

When you exit from the WM window, you will be returned to the XEDIT 
environment. 

Invoking Full-Screen CMS from XEDIT 

If you set full-screen CMS ON while you are in the XEDIT environment, the CMS 
window will be displayed and you will be able to enter commands in the WM 
window. In this case, the XEDIT window is not visible. To make the XEDIT 
window visible again, you can use the CMS POP WINDOW command, specifying 
the window name that XEDIT is using. 

Similarly, if you get into a situation where the active window is not large enough for 
you to enter a command, you can use the PAl key, which has a default setting of 
POP WINDOW WM, to get the WM window displayed. You can then enter CMS 
commands to adjust the window. For example, you can use the CMS MAXIMIZE 
WINDOW to make the window larger. 

Disconnect/Reconnect Considerations 

If, while in XEDIT, you disconnect from your terminal and later reconnect to a 
different type of terminal, the virtual screen and/or window that XEDIT uses may be 
re-sized to fit the dimensions of the new terminal. 

The virtual screen and/or window will change as follows: 

• If, before disconnecting, you have not defined the virtual screen and window 
(this is the default situation), then after reconnecting: 

1 . Virtual screens are redefined according to the procedure described earlier in 
this appendix. 
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Usage Notes 



2. Windows are resized to fit the new physical screen. 

• If you have defined a virtual screen prior to disconnecting, no adjustments will 
be made to it after reconnecting. 

• If you have defined a window prior to disconnecting, and then you reconnect to 
a smaller screen, the window will be adjusted to fit on the new screen. No 
adjustment is made when reconnecting to an equivalent or larger screen. 

Note: If you define the XEDIT virtual screen before disconnecting and then 
reconnect onto a smaller screen, the XEDIT window may be adjusted such that the 
resulting window is smaller than the virtual screen. In such a case, the command 
Une may not be visible in the window. Here you can use the PAl key, which has a 
default setting of POP WINDOW WM, to get the WM window displayed. You can 
then use the CMS SCROLL command to position the command line in the window. 



1 , On leaving XEDIT, any virtual screens or windows XEDIT defined, including 
the default XEDIT virtual screen and window, are deleted. Only user-defined 
virtual screens and windows remain. XEDIT also clears any virtual screens and 
hides any windows it used but did not create. 

Note that if full-screen CMS is ON and there are multiple XEDIT sessions, the 
CMSOUT window will be hidden only after leaving the last one. 

2. If, during an XEDIT session, you delete the virtual screen that XEDIT is using, 
XEDIT will redefine the virtual screen according to the guidelines explained in 
Table 3 on page 441. 

3. When a virtual screen is used or has been used by XEDIT, the following CMS 
commands are invalid for that virtual screen: 

CLEAR VSCREEN 
CURSOR VSCREEN 
GET VSCREEN 
PUT VSCREEN 
ROUTE 
SET LOGFILE 
SET VSCREEN 
WAITT VSCREEN 
WAITREAD VSCREEN 
WRITE VSCREEN 

Also, when XEDIT uses a virtual screen, it uses the screen area settings 
(PRotect/NOProtect, High/NOHigh, color, exthi, psset) defined by XEDIT SET 
subcommands. These XEDIT-defined settings override any settings that may 
have been specified on the CMS DEFINE VSCREEN command. 

4, If the WINDOW option is specified on the XEDIT command and XEDIT uses 
an existing virtual screen, then the virtual screen settings will be changed as 
follows: 

a. The virtual screen TYPE/NOTYPE setting will be set to TYPE. 

b. If logging has been specified for that virtual screen, then it will be set to 
OFF. 

c. If full-screen CMS is ON, any message classes routed to that virtual screen 
will be re-routed to the CMS virtual screen. 
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5. It is possible in certain situations to position your window such that the 
command line is not visible in the window. To avoid problems, you should 
establish a method (setting a PF key, for example) to make the command line 
visible again. 

6. If full-screen CMS is ON and abend processing occurs while you are in XEDIT, 
the CMS window will be displayed with the CMSOUT window popped on top 
of it. Entering a command will cause the CMSOUT window to be hidden if it is 
of type SYSTEM or deleted if it is of type USER. 

Working in Line-mode 

If the XEDIT terminal setting is "TYPEWRITER," then output is written a hne at a 
time to CMS. CMS displays the output based on the terminal type and the 
full-screen setting. 

Under certain circumstances, when you are using the editor in typewriter mode on a 
display terminal, the CMSOUT window may appear. For example, suppose you are 
in typewriter mode and you invoke a separate XEDIT session with the CMS XEDIT 
command, then set full-screen CMS ON during that XEDIT session. Upon exit 
from full-screen CMS, the CMSOUT window may remain on your screen even 
though you are now editing in typewriter mode. 
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Appendix H. A Summary of XEDIT Subcommands and Macros 



Subcommand 


Purpose 


Add 


Add n line(s) after current line. 


ALL 


Select a collection of lines for display /editing. 


ALter 


Change a single character to another (character or hex). 


BAckward 


Scroll backward n screen displays. 


Bottom 


Go to last line of file. 


CANCEL 


Terminate the editing session for all files. 


CAppend 


Add text to end of current line. 


CDelete 


Delete characters, starting at column pointer. 


CFirst 


Move column pointer to beginning of line (zone). 


Change 


Change one string to another. 


CInsert 


Insert text starting at the column pointer of the current line. 


CLAst 


Move the column pointer to the end of the line (zone). 


CLocate 


Locate a string; move the column pointer and the line 
pointer. 


CMS 


Pass a command to CMS, or enter CMS subset mode. 


CMSG 


Display message in command line of user's screen. 


COMMAND 


Execute a subcommand without checking for synonym or 
macro. 


COMPress 


Prepare line(s) for realignment by replacing blanks with tab 
characters. 


copy 


Copy Une(s) at specified location. 


count 


Display the number of times a string appears. 


COVerlay 


Replace characters, starting at column pointer. 


CP 


Pass command to VM/SP control program. 


CReplace 


Replace characters, starting at the column pointer. 


CURsor 


Move the cursor to specified position on the screen, and 
optionally assign a priority for this position. 


DELete 


Delete line(s) beginning with the current Hne. 


Down 


Move line pointer n lines toward end of file (same as 

NEXT). 


DUPlicat 


Duplicate line(s). 


EMSG 


Display a message and sound the alarm. 


EXPand 


Reposition data according to new tab settings. 


EXTract 


Return information about internal XEDIT variables and 
file data. 
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Subcommand 


Purpose 


FILE 


Write file to disk or directory. 


Find 


Search for line that starts with specified text. 


FINDUp 


Search for a line that starts with specified text; searches in a 
backward direction. 


FOrward 


Scroll forward n screen displays. 


GET 


Insert lines from another file. 


Help 


Request online display of XEDIT subcommands and 
macros; invoke the CMS HELP faciUty. 


HEXType 


Display Une(s) in hexadecimal and EBCDIC. 


Input 


Insert a single line, or enter input mode. 


Join 


Combine two or more lines into one Une. 


LEft 


View data to the left of column one. 


LOAD 


Read file into storage; use in profile macro only. 


Locate 


Move Une pointer to specified target. 


LOWercas 


Change uppercase letters to lowercase. 


LPrefix 


Simulate writing in the prefix area of the current line. Used 
on typewriter terminals. 


MACRO 


Execute macro without checking for subcommand or 
synonym. 


MErge 


Combine two sets of lines. 


MODify 


Display a subcommand and its current values in the 
command line, so it can be overtyped and reentered. 


MOve 


Move hne(s) to another place in the file. 


MSG 


Display message in message Une. 


Next 


Move line pointer n Unes toward end of file (same as 
DOWN). 


NFind 


Search forward for first line that does not start with the 
specified text. 


NFINDUp 


Search backward for first line that does not start with the 
specified text. 


Overlay 


Replace characters in current line. 


PARSE 


Scan a line of a macro to check the format of its operands. 


POWerinp 


Enter an input mode for continuous typing. 


PREServe 


Save settings of XEDIT variables until RESTORE is 
entered. 


PURge 


Remove macro from virtual storage. 


PUT 


Insert hnes into another file (new or existing), or into a 
buffer (to be retrieved by GET from another file). 


PUTD 


Same as PUT, but delete original Unes. 
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Subcommand 


Purpose 


Query 


Display the current value of editing options. 


QUIT 


End an editing session without saving changes. 


READ 


Place information from the terminal in the console stack. 


RECover 


Replace removed Hues. 


REFRESH 


Issued from a macro, it updates the display on the screen. 


RENum 


Renumber VSBASIC or FREEFORT files. 


REPEat 


Advance line pointer and reexecute last subcommand. 


Replace 


Replace current line, or delete current line and enter input 
mode. 


RESet 


Remove prefix subcommands or macros when screen is in 
"pending" status. 


RESTore 


Restore settings of XEDIT variables to values they had 
when PRESERVE was issued. 


RGTLEFT 


Shift display to the right or left; reissue to shift back to 
original display. 


Right 


View data to the right of the last (right-most) column. 


SAVE 


Write file to disk or directory and remain in edit mode. 


SCHANGE 


Locate string and make a selective change, using PF keys. 


SET ALT 


Change the number of alterations that have been made to 
the file since the last AUTOSAVE and/or since the last 
SAVE. 


SET APL 


Inform the editor and CMS if APL keys are used. 


SET ARBchar 


Define an arbitrary character to be used in a target 
definition. 


SET AUtosave 


Automatically issue a SAVE subcommand at specified 
intervals. 


SET BRKkey 


Specifies whether or not CP should break in when the 
"BRKKEY " (defined by CP TERMINAL BRKKEY) is 

pressed. 


SET CASE 


Uppercase or lowercase control; specify if case is significant 
in target searches. 


SET CMDline 


Move the position of the command Hne. 


SET COLOR 


Associate specific colors and attributes with various fields 
on the XEDIT screen. 


SET COLPtr 


Specify if column pointer is displayed (typewriter terminals 
only). 


SET CTLchar 


Define a control character(s), which associate parts of a 
reserved hne with highlighting, protection, visibiUty, various 
colors, extended highlighting, and Programmed Symbol 
Sets. 


SET CURLine 


Define the position of the current hne on the screen. 
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Subcommand 


Purpose 


SET Display 


Indicate which selection levels of lines will be displayed on 
the screen. 


SET ENTer 


Define a meaning for the ENTER key. 


SET Escape 


Define a character that allows you to enter a subcommand 
while in input mode (typewriter terminals only). 


SET ETARBCH 


Define an arbitrary character within a file containing 
Double-Byte Character Set (DECS) characters to be used in 
target definitions. 


SET ETMODE 


Inform the editor that there are Double-Byte Character Set 
strings in the file. 


SET FILler 


Define a character that is used when a line is expanded. 


SETFMode 


Change the file mode of the current file. 


SET FName 


Change the file name of the current file. 


SET FType 


Change the file type of the current file. 


SET FULLread 


Determine whether or not the editor and CMS recognize 
null characters in the middle of screen lines. 


SET HEX 


Allows string operands and targets to be specified in 
hexadecimal. 


SET IMage 


Control how tabs and backspaces are handled when a hne 
is entered. 


SET IMPcmscp 


Control whether subcommands not recognized by the editor 
are transmitted to CMS and CP. 


SET LASTLorc 


Define the contents of the last locate or change buffer. 


SET LINENd 


Define a Hne end character. 


SET LRecl 


Define a new logical record length. 


SET MACRO 


Control the order in which the editor searches for 
subcommands and macros. 


SET MASK 


Define a new mask, which is the contents of added Hnes 
and the input zone. 


SET MSGLine 


Define position of message line and the number of lines a 
message may expand to. 


SET MSGMode 


Control the message display. 


SET NONDisp 


Define a character to XEDIT and CMS that is used in 
place of non-displayable characters. 


SET NULls 


Specify whether traihng blanks are replaced with nulls to 
allow character insertion. 


SET NUMber 


Specify whether file line numbers are displayed in the prefix 
area. 


SET PAn 


Define a meaning for a PA key. 


SET PACK 


Specify if the file is to be written in packed format to disk 
or directory. 
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Subcommand 


Purpose 


SET PENDing 


Control the execution of a prefix macro and the status of 
the screen while the macro is being executed. 


SET PFn 


Define a meaning for a PF key. 


SET Point 


Define a symboUc name for the current Une. 


SET PREfix 


Control the display of the prefix area or define a synonym 
for a prefix subcommand. 


SET RANge 


Define a new "top" and "bottom" for the file. 


SET RECFm 


Define the record format. 


SET REMote 


Control the way data transmission is handled in XEDIT 
and CMS. 


SET RESERved 


Reserve a line, which cannot be used by the editor. 


SET SCALe 


Control the display of the scale line. 


SET SCOPE 


Specify whether the editor operates on the entire file or on 
only those lines displayed. 


SET SCReen 


Divide the screen into logical screens, for multiple views of 
the same or of different files. 


SET SELect 


Assign a selection level to a line or group of Unes in a file. 


SET SERial 


Control file serialization. 


SET SHADOW 


Specify whether the file is to be displayed with or without 
shadow lines indicating where lines have been excluded 
from the display. 


SET SIDcode 


Specify a character string that is to be inserted into every 
line of an update file. 


SET SPAN 


Allows a string target to span a number of lines. 


SET SPILL 


Control whether or not truncation will occur for certain 
subcommands. 


SET STAY 


Specify for certain subcommands whether the line pointer 
moves when searching for a string. 


SET STReam 


Specify whether the editor searches only the current line or 
the whole file for a column-target. 


SET SYNonym 


Specify whether the editor looks for synonyms; assign a 
synonym. 


SET TABLine 


Control the display of the tab line. 


SET TABS 


Define the logical tab stops. 


SET TERMinal 


Specify whether a terminal is used in line mode or 
full-screen mode. 


SET TEXT 


Inform the editor and CMS if TEXT keys are used. 


SET TOFEOF 


Control the display of TOF/EOF Unes. 


SETTRANSLat 


Control user-defined uppercase translation. 


SET TRunc 


Define the truncation column. 
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Subcommand 


Purpose 


SET VARblank 


Specify whether the number of blanks between two words is 
significant in a target search. 


SET Verify 


Control whether lines changed by subcommands are 
displayed; define the columns displayed and whether 
displayed in EBCDIC, hexadecimal or both. 


SET WRap 


Control whether the editor wraps around the file if EOF (or 
TOP for backwards searches) is reached during a search. 


SET Zone 


Define new limits within each hne for target searches. 


SET = 


Insert string into the equal buffer. 


SHift 


Move data right or left (data loss possible). 


SI 


Continuously add lines and position cursor for indented 
text. 


SORT 


Sort all or part of a file, in ascending or descending order. 


SOS 


Specify functions for screen operation simulation. 


SPlit 


SpHt a line into two or more Hues. 


SPLTJOIN 


Split a Hne or join two Unes at the cursor. 


STAck 


Place Hne(s) from the file into the console stack. 


STATUS 


Display SET subcommand current settings; create a macro 
that contains these settings. 


TOP 


Move Une pointer to null TOP OF FILE Une. 


TRAnsfer 


Place editing variable(s) in the console stack, for use by a 
macro. 


Type 


Display hnes. 


Up 


Move Hne pointer n Hnes toward top of file. 


UPPercas 


Translate all lowercase characters to uppercase. 


Xedit 


Edit multiple files. 


& 


Use before a subcommand to redisplay the command. 


= 


Reexecute the last subcommand, macro, or CP/CMS 
command. 


•> 


Display the last subcommand, macro, or CP/CMS 
command executed. 



Prefix 


Subcommands 


A 


Add Hne(s). 


C 


Copy Hne(s). 


D 


Delete Hne(s). 


E 


Extend a Hne. 


F 


Move or copy following this Hne. 


I 


Insert Hne(s). 
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Prefix 


Subcommands 


M 


Move line(s). 


P 


Move or copy preceding this line. 


SI 


Continuously add lines and position cursor for 
indented text. 


II 


Duplicate line(s). 


/ 


Make this line the current line. 


SCALE 


Display the scale on this line. 


TABL 


Display the tab line on this line. 


.xxxx 


Assign symbolic name to this line. 


X 


Exclude line(s) from display. 


S 


Show excluded line(s). 


< 


Shift line(s) to the left. 


> 


Shift Une(s) to the right. 
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Summary of Changes 



Previous editions of this book may be ordered using the pseudo-number found in the 
VM/SP Release 6.0 Library Guide, Glossary, and Master Index. 

Summary of Changes 
for SC24-5221-05 
VM/SP Release 6 

The XEDIT enhancements described in this document provide new or improved 
support in the following areas: 

• Shared File System 

— Two new options for the CMS XEDIT command, the XEDIT subcommand, 
and the LOAD subcommand: 

lock|nolock 

— A new option for the QUERY subcommand: 
EDIRNAME 

— Two new options for the EXTRACT subcommand: 

LOCK 
EDIRNAME 

— The format of the EMSG subcommand has been enhanced to accept both 
three-digit and four-digit message numbers. 

• Miscellaneous 

Several minor technical and editorial improvements have been made. 

Summary of Changes 
for SC24-5221-4 
VM/SP Release 5 

The XEDIT enhancements described in this document provide new or improved 
support in the following areas: 

• Windowing Support 

A new appendix describing virtual screens and windows. 

A new option for the XEDIT command and the LOAD subcommand: 

WINDOW 

Two new options for the EXTRACT subcommand: 

WINDOW 
NBSCOPE 

• National Language Support (NLS) Enhancements 

NLS Central Message FaciUty— Most of the XEDIT error messages have 
been changed in the interest of clarity and usability. 

NLS Parsing Facility— An entry has been added to Appendix A for DLCS 
(Definition Language for Command Syntax). 
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• HELP Enhancements 

The user can now use the HELP subcommand to find brief and related 
information about a command. This is documented under the HELP 
subcommand. 

• Miscellaneous 

Appendix G, "Nondisplayable Character Translation Tables," has been 
moved to the VM/SP Terminal Reference. 

Summary of Changes 
for SC24-5221-3 
VM/SP Release 4 

The XEDIT enhancements described in this document provide new or improved 
support in the following areas: 

• Double-Byte Character Set Support (Extended Mode) 

A new appendix describing Double-Byte Character Set Support 
New commands: 

SET ETARBCH 
SET ETMODE 

New options for EXTRACT, QUERY, and MODIFY subcommands: 

ETARBCH 
ETMODE 

• MACLIB support 

New option for XEDIT and LOAD subcommands: 

MEMBER membername 

New options for EXTRACT and QUERY subcommands: 

LIBNAME 
LIBTYPE 
MEMBER 

• Usability Enhancements 

All messages issued by the editor are in mixed case. 

• Miscellaneous 

Programmed symbol set support added to: 

SET COLOR 
SET CTLCHAR 
SET RESERVED 

EXTRACT CURLINE enhanced 

TASK option added to HELP subcommand 

SI (Structured Input) new subcommand and prefix macro 

SET BRKKEY new subcommand 

File type defaults for BASIC and BASDATA enhanced 
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Glossary of Terms and Abbreviations 



abend. (1) Abnormal end of task. (2) Synonym for 
abnormal termination. 

abnormal termination. The ending of processing before 
planned termination. Synonymous with abend. 

Advanced Program-to-Program Communications/VM 
(APPC/VM). An API for communicating between two 
virtual machines that is mappable to the SNA LU 6.2 
APPC interface and based on lUCV functions. Along 
with the TSAF virtual machine, APPC/VM provides 
this communication within a single system and 
throughout a collection of systems. 

alphameric. Synonym for alphanumeric. 

alphanumeric. Pertaining to a character set that 
contains letters, digits, and usually other characters, 
such as punctuation marks. Synonymous with 
alphameric. 

APPC/VM. Advanced Program-to-Program 
Communications/VM . 

assembler language. A source language that includes 
symbolic machine language statements in which there is 
a one-to-one correspondence with instruction formats 
and data formats of the computer. 

attention interrupt. An I/O interrupt caused by a 
terminal user pressing the attention key (or equivalent). 
See attention key (ATTN key). 

attention key (ATTN key). A function key on terminals 
that, when pressed, causes an I/O interruption in the 
processing unit. 

ATTN key. Attention key. 

authority. In SFS, the permission to access a file or 
directory. You can have read authority or write 
authority (which includes read authority). You can also 
have file pool administration authority, which is the 
highest level of authority in a file pool. 

AUX file. Auxiliary control file. 



B 



buffer. An area of storage, temporarily reserved for 
performing input or output, into which data is read, or 
from which data is written. 



CMS. Conversational Monitor System. 

CMS editor. A CMS facility that lets the user create, 
change, insert, delete, or rearrange lines of data in a 
CMS file. See edit mode and input mode. 

CMS EXEC language. A general-purpose, high-level 
programming language, particularly suitable for EXEC 
procedures and EDIT macros. The CMS EXEC 
processor executes procedures and macros (programs) 
written in this language. Contrast with EXEC 2 
language and Restructured Extended Executor (REXX) 
language. 

CMS files. Refers exclusively to files in the fixed-block 
format used by CMS file system commands. VSAM 
and OS data sets and DOS files are not compatible with 
the CMS file format and cannot be manipulated using 
CMS file system commands. 

CMS file system. A way to create files in the CMS 
system. CMS files are created by using an identifier 
consisting of three fields: file name, file type, and file 
mode. These files are unique to the CMS system and 
cannot be read or written using other operating systems. 

command. A request from a user at a terminal for the 
execution of a particular CP, CMS, IPCS, GCS, TSAF, 
or AVS function. A CMS command can also be the 
name of a CMS file with a file type of EXEC or 
MODULE. See subcommand. 

command abbreviation. A short form of the command 
name, operand, or option that is not a truncation of the 
word. For example, MSG instead of MESSAGE, RDR 
instead of READER. Contrast with truncation. 

command line. The line at the bottom of display panels 
that lets a user enter commands or panel selections. It 
is prefixed by an arrow (= = = = >). 

component. A collection of objects that together form a 
separate functional unit. A product may contain many 
components (for example, VM/SP has components of 
CP, CMS, GCS, TSAF, IPCS, and AVS). A component 
can be part of many products. (CP spans both VM/SP 
and VM/HPO products.) 

console stack. Refers collectively to the program stack 
and the terminal input buffer. 

control block. A storage area that a computer program 
uses to hold control information. 
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control program. A computer program that schedules 
and supervises the program execution in a computer 
system. Sqq Control Program (CP). 

Control Program (CP). A component of VM/SP that 
manages the resources of a single computer so multiple 
computing systems appear to exist. Each virtual 
machine is the functional equivalent of an IBM 
System/370. 

Conversational Monitor System (CMS). A virtual 
machine operating system and component of VM/SP 
that provides general interactive time sharing, problem 
solving, program development capabilities, and operates 
only under the control of the VM Control Program 
(CP). 

CP. Control Program. 

CP command. A command available to all VM users. 
Class G CP commands let the general user reconfigure 
their virtual machine, control devices attached to their 
virtual machine, do input and output spooling functions, 
and simulate many other functions of a real computer 
console. Other CP commands let system operators, 
system programmers, system analysts, and service 
representatives manage the resources of the system. 

current line pointer (CLP). A pointer that indicates the 
line of a CMS file on which the CMS Editor or the 
System Product Editor (XEDIT) is currently working. 



DBCS. Double-byte character set. 

directory. See SFS directory. 

disk. A magnetic disk unit in the user's CMS virtual 
machine configuration. Also called a virtual disk. 

disk operating system (DOS). An operating system for 
computer systems that use disks and diskettes for 
auxihary storage of programs and data. 

display mode. A type of editing at a display terminal in 
which an entire screen of data is displayed at once and 
in which the user can access data through commands or 
by using a cursor. Contrast with line mode. 

display terminal. A terminal with a component that can 
display information on a viewing surface such as a CRT 
or gas panel. 

DOS. Disk operating system. 

double-byte character set (DBCS). A character set that 
requires 2 bytes to uniquely define each character. This 
contrasts with EBCDIC, in which each printed character 
is represented by 1 byte. 



edit. A function that makes changes, additions, or 
deletions to a file on a disk. These changes are 
interactively made. The edit function also generates 
information in a file that did not previously exist. 

edit mode. The environment in which CMS EDIT 
subcommands and System Product Editor (XEDIT) 
subcommands can be entered by the user to insert, 
change, delete, or rearrange the contents of a CMS file. 
Contrast with input mode. 

EOF. End of file. 

EXEC 2 language. A general-purpose, high-level 
programming language, particularly suitable for EXEC 
procedures and XEDIT macros. The EXEC 2 processor 
runs procedures and XEDIT macros (programs) written 
in this language. Contrast with CMS EXEC language 
and Restructured Extended Executor (REXX) language. 



file ID. A CMS file identifier that consists of a file 
name, file type, and file mode. The file ID is associated 
with a particular file when the file is created, defined, or 
renamed under CMS. See file name, file type, and file 
mode. 

file mode. A two-character CMS file identifier field 
comprised of the file mode letter (A through Z) 
followed by the file mode number (0 through 6). The 
file mode letter indicates the minidisk or SFS directory 
on which the file resides. The file mode number 
indicates the access mode of the file. 

file name. A one-to-eight character alphanumeric field, 
comprised of A through Z, through 9, and special 
characters $ # @ + - (hyphen) : (colon) _ (underscore), 
that is part of the CMS file identifier and serves to 
identify the file for the user. 

file pool. A collection of minidisks managed by SFS. It 
contains user files and directories and associated control 
information. Many users' files and directories can be 
contained in a single file pool. 

file space. A user's allocation of space within a file 
pool. 

file type. A one-to-eight character alphanumeric field, 
comprised of A through Z, through 9, and special 
characters $ # @ + - (hyphen) : (colon) _ (underscore), 
that is used as a descriptor or as a qualifier of the file 
name field in the CMS file identifier. See reserved file 
types. 

full-screen CMS. When a user enters the command 
SET FULLSCREEN ON, CMS is in a window and can 
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take advantage of 3270-type architecture and windowing 
support, and various classes of output are routed to a 
set of default windows. Also, users can type commands 
anywhere on the physical screen and scroll through 
commands and responses previously displayed. See 
windowing. 



I 



input line. For typewriter terminals, information keyed 
in by a user between the time the typing element of the 
terminal comes to rest following a carriage return until 
another carriage return is typed. For display terminals, 
the data keyed into the user input area of the screen. 
See user input area. 

input mode. In the CMS Editor or System Product 
Editor (XEDIT), the environment that lets the user key 
in new lines of data. Contrast with edit mode. 

interrupt. A suspension of a process, such as execution 
of a computer program, caused by an external event and 
done in such a way that the process can be resumed. 

invoke. To start a command, procedure, or program. 



line end symbol. Synonym for logical line end symbol. 

line mode. The mode of operation of a display terminal 
that is equivalent to using a typewriter-Uke terminal. 
Contrast with display mode. 

line number. A number located at either the beginning 
or the end of a record (line) that can be used during 
editing to refer to that Une. 

load. In reference to installation and service, to move 
files from tape to disk, auxiliary storage to main 
storage, or minidisks and directories to virtual storage 
within a virtual machine. 

lock. A tool for controlling concurrent usage of SFS 
objects. Implicit locks are acquired and automatically 
released when you run CMS commands and program 
functions in SFS. Explicit locks let you control the type 
and duration of the lock. 

logical line. A command or data line that can be 
separated from one or more additional command or 
data lines on the same input line by a logical line end 
symbol. 

logical line end symbol. A special editing symbol, 
usually the pound (#) sign, that lets the user key in the 
equivalent of several command or data lines in the same 
physical line; that is, each logical line except the last line 



is terminated with the logical line end symbol. 
Synonymous with line end symbol. 



M 



minidisk. A logical subdivision (or all) of a physical 
disk pack that has its own virtual device address, 
consecutive virtual cylinders (starting with virtual 
cylinder 0), and a VTOC or disk label identifier. Each 
user virtual disk is preallocated and defined by a VM/SP 
directory entry as belonging to a user. 

module. A unit of a software product that is discretely 
and separately identifiable with respect to modifying, 
compiling, and merging with other units, or with respect 
to loading and execution. For example, the input to, or 
output from, a compiler, the assembler, the linkage 
editor, or an exec routine. 



N 



null line. A logical line with a length of zero that 
usually signals the CMS Editor to end input mode and 
enter edit mode. In VM/SP, a null line for typewriter 
terminals is a terminal input line consisting of a return 
character as the first and only information, or a logical 
line end symbol as the last character in the data line. 
For display devices, a null line is indicated by the cursor 
positioned at the beginning of the user input area or the 
data in the user input area ending with a logical line end 
symbol. 



operand. Information entered with a command name to 
define the data on which a command processor operates 
and to control the execution of the command processor. 



parameter. A variable that is given a constant value for 
a specified application and that may denote the 
application. 

password. In computer security, a string of characters 
known to the computer system and a user, who must 
specify it to gain full or limited access to a system and 
to gain full or limited access to a system and to the data 
stored within it. 

FF key. Program function key. 

physical screen. Synonym for screen. 

preflx area. The five left-most positions on the System 
Product Editor's full-screen display, in which prefix 
subcommands or prefix macros can be entered. See 
prefix macros and prefix subcommands. 
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prefix macros. System Product Editor macros entered 
in the prefix area of any line on a full-screen display. 
See prefix area. 

prefix subcommands. System Product Editor 
subcommands entered in the prefix area of any line on a 
full-screen display. See prefix area. 

program function (PF) key. On a terminal, a key that 
can do various functions selected by the user or 
determined by an application program. 

program stack. Temporary storage for lines (or files) 
being exchanged by programs that execute under CMS. 
See console stack. 

prompt. A displayed message that describes required 
input or gives operational information. 

prompting. An interactive technique that lets the 
program guide the user in supplying information to a 
program. The program types or displays a request, 
question, message, or number, and the user enters the 
desired response. The process is repeated until all the 
necessary information is supplied. 



REXX program. Synonym for REXX EXEC. 

ring of files. The arrangement of files in virtual storage 
when multiple files are being edited by the System 
Product Editor. 



scale. A line on the System Product Editor's (XEDIT) 
full-screen display, used for column reference. 

screen. An illuminated display surface; for example, the 
display surface of a CRT. Synonymous with physical 



scrolling. (1) Moving a display image vertically or 
horizontally in order to view data not otherwise visible 
within the boundaries of the display screen. 
(2) Performing a scroll up, scroll down, scroll right, or 
scroll left operation. 

selective line editing. A feature of XEDIT that allows 
editing of a specified collection of lines while excluding 
other lines from the screen. 

SFS. Shared file system. 



read authority. The authority to read the contents of a 
file without being able to change them. For a directory, 
read authority lets the user view the names of the 
objects in the directory. 

receive. Bringing into the specified buffer data sent to 
the user's virtual machine from another virtual machine 
or from the user's own virtual machine. 

reserved file types. File types recognized by the CMS 
editors (EDIT and XEDIT) as having specific default 
attributes that include: record size, tab settings, 
truncation column, and uppercase or lowercase 
characters associated with that particular file type. The 
CMS Editor creates a file according to these attributes. 

Restructured Extended Executor (REXX) language. A 

general-purpose programming language, particularly 
suitable for EXEC procedures, XEDIT macros, or 
programs for personal computing. Procedures, XEDIT 
macros, and programs written in this language can be 
interpreted by the System Product Interpreter. Contrast 
with CMS EXEC language and EXEC 2 language. 

REXX EXEC. An EXEC procedure or XEDIT macro 
written in the REXX language and processed by the 
System Product Interpreter. Synonymous with REXX 
program. 



REXX language. 

language. 



Restructured Extended Executor 



SFS directory. A group of files. SFS directories can be 
arranged to form a hierarchy in which one directory can 
contain one or more subdirectories as well as files. 

shared file system (SFS). A part of CMS that lets users 
organize their files into groups known as directories and 
to selectively share those files and directories with other 
users. 

source file. A file that contains source statements for 
such items as high-level language programs and data 
description specifications. 

source update file. A file containing a single change to 
a statement in a source file. The file can also include 
requisite information for applying the change. 
Synonymous with update file. 

subcommand. The commands of processors such as 
EDIT or System Product Editor (XEDIT) that run 
under CMS. 

synonym. In CMS, an alternative command name 
defined by the user as equivalent to an existing CMS 
command name. Synonyms are entries in a CMS file 
with a file type of SYNONYM. Entering the 
SYNONYM command allows use of those synonyms 
until that terminal session ends or until the use of 
synonyms is revoked by entering the SYNONYM 
command with no operands. 

syntax. The rules for the construction of a command or 
program. 
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System Product Editor. The CMS facility, comprising 
the XEDIT command and XEDIT subcommands and 
macros, that lets a user create, change, and manipulate 
CMS files. 

System Product Interpreter. The language processor of 
the VM/SP operating system that processes procedures, 
XEDIT macros, and programs written in the REXX 
language. 



user-written CMS command. Any CMS file created by 
a user that has a file type of MODULE or EXEC. Such 
a file can be executed as if it were a CMS command by 
issuing its file name, followed by any operands or 
options expected by the program or EXEC procedure. 



virtual machine (VM). 

machine. 



A functional equivalent of a real 



target. One of many ways to identify a line to be 
searched for by the System Product Editor. A target 
can be specified as an absolute line number, a relative 
displacement from the current Une, a Kne name, or a 
string expression. 

terminal. A device, usually equipped with a keyboard 
and a display, capable of sending and receiving 
information. 

terminal input buffer. Holds lines entered at the user's 
terminal until CMS processes them. 

truncation. A valid shortened form of CP, CMS, GCS, 
IPCS, RSCS, TSAF (Query only) command names, 
operands, and options that can be keyed in. When the 
shortened form is used, the number of key strokes is 
reduced. For example, the ACCESS command has a 
minimum allowable truncation of two, so AC, ACC, 
ACCE, ACCES, and ACCESS are all recognized by 
CMS as the ACCESS command. 

truncation setting. In the CMS Editor, the value that 
determines the maximum length of input lines. 

typewriter terminal. Printer-keyboard devices that 
produce hardcopy output only, such as: the IBM 2741 
Communication Terminal; the IBM 3215 Console 
Printer-Keyboard; the IBM 3767 Communication 
Terminal, Model 1 or 2, operating as a 2741. This term 
also refers to the IBM 3101 Display Terminal operating 
as a 2741. 



u 



update file. Synonym for source update file. 

user. Anyone who requests the services of a computing 

system. 

user input area. On a display device, the hues of the 
screen where the user is required to key in command or 
data lines. See display mode, input line, and line mode. 



Virtual Machine/System Product (VM/SP). An IBM 
licensed program that manages the resources of a single 
computer so that multiple computing systems appear to 
exist. Each virtual machine is the functional equivalent 
of a real machine. 

virtual screen. A functional simulation of a physical 
screen. A virtual screen is a presentation space where 
data is maintained. The user can view pieces of the 
virtual screen through a window on the physical screen. 

virtual storage. Storage space that can be regarded as 
addressable main storage by the user of a computer 
system in which virtual addresses are mapped into real 
addresses. The size of virtual storage is limited by the 
addressing scheme of the computing system and by the 
amount of auxiliary storage available, and not by the 
actual number of main storage locations. 

VM. Virtual machine. 

VM/SP. Virtual Machine/System Product. 

vscreen. Virtual screen. 



W 



window. An area on the physical screen where virtual 
screen data can be displayed. Windowing lets the user 
do such functions as defining, positioning, and 
overlaying windows; scrolling backward and forward 
through data; and writing data into virtual screens. 

windowing. A set of functions that lets the user view 
and manipulate data in user-defined areas of the 
physical screen called windows. Windowing support lets 
the user define, position, and overlay windows; scroll 
backward and forward through data; and write data into 
virtual screens. 

write authority. The authority to read or change the 
contents of a file or directory. Write authority imphes 
read authority. 
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XEDIT. See System Product Editor. 



with REXX or EXEC 2 control statements to control 
processing within the procedure. (2) A CMS file with a 
file type of XEDIT. 



XEDIT macro. (1) A procedure defined by a 
fi-equently used command sequence to do a commonly 
required editing fimction. A user creates the macro to 
save repetitious rekeying of the sequence, and invokes 
the entire procedure by entering a command (that is, the 
macro file's file name). The procedure can consist of a 
long sequence of XEDIT commands and subcommands 
or both, and CMS and CP commands or both, along 



zone-setting. In the CMS editor, a number range that 
specifies the positions within each data line that can be 
scanned and edited. In the System Product Editor, the 
starting position and ending position (columns) of each 
record within which the editor searches for targets. 
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""" pending... 402 
PENDING option 

of EXTRACT 80 

of SET 265 
PF keys 

assigning a sequence of subcommands to 269 

defining meaning for 268 

removing meaning from 268 

used in SCHANGE 200 

using in input mode 109 
PFILE subcommand 92 
PFn option 

of EXTRACT 81 

of QUERY 168 

of SET 268 

of TRANSFER 354 
POINT option 

of EXTRACT 82 

of QUERY 168 

of SET 271 

of TRANSFER 354 
pound sign as default line-end character 245 
power typing 

causing a break in data typed in 1 52 

entering data with 152 

using a line end character 152 

using the insert key 1 52 
POWERINP subcommand 152 

used with windowing support 153 



POWERINP subcommand (continued) 

using a line end character 1 52 
PQUIT subcommand 174 
preceding Hne as destination 387 
prefiUing line with mask 250 
prefix area 

controlling display 273 

entering subcommands in 371 

resetting 189, 373 

using LPREFIX to simulate 130 
prefix macros 

list of 371 

menu display of 104 

rules for entering 37 1 
PREFIX option 

of EXTRACT 82 

of QUERY 168 

of SET 273 

of TRANSFER 354 
prefix subcommand 

A 376 

C 377 

D 379 

defining synonym for 273 

E 381 

F 382 

I 383 

list of 371 

M 384 

menu display of 104 

P 387 

removing from screen 189 

rules for entering 371 

SCALE 389 

TABL 393 

.xxxx 396 

/ 399 

" 402 
PRESERVE subcommand 154 
printer spool 

copying contents of 
using PF key 268 
priority 

CURSOR subcommand 59 

prefix subcommands and macros 374 
profile macro 

not executing 6 

specifying macro name 6 

used to prompt for options in 117 

using LOAD in 117 
program function key 

See PF keys 
protected QUIT 24, 174 
PS AVE subcommand 196 
PURGE subcommand 155 
PUT subcommand 156 

example of 1 58 

with DBCS strings 432 
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PUTD subcommand 159 
with DBCS strings 432 



QQUIT subcommand 174 
QUERY subcommand 162 

options 162 
QUIT subcommand 174 

protected 24, 174 

unprotected 24, 174 
versus QQUIT 174 
quitting multiple files 24 

R 

RANGE option 
of EXTRACT 82 
of QUERY 168 

of SET 275 

of TRANSFER 354 
range, defining 275 
READ subcommand 176 
realign data 

example of 47 

sequence used to 46 
RECFM option 

of EXTRACT 83 

of QUERY 168 

of SET 277 

of TRANSFER 354 
reconnecting after disconnect 317 
reconnecting an XEDIT session 288, 443 
record format 

defining 277 

fixed, logical record length of 277 

variable, logical record length of 277 
RECOVER subcommand 180 
recovering deleted lines 180 
recursive editing 8 
redisplaying a subcommand 

using & 368 

using ? 370 
reexecuting a subcommand 

using REPEAT 185 

using = 369 
REFRESH subcommand 182 
RELATED task menus 104 
relative column number, specifying column-target 

as 39 
relative displacement, specifying target as 123 
REMOTE option 

of EXTRACT 83 

of QUERY 168 

of SET 278 
removing macros in virtual storage 155 
removing prefix subcommands 189 



RENUM subcommand 183 

renumber line numbers of VSBASIC or FREEPORT 

files 183 
REPEAT subcommand 185 
repeating last subcommand 185 
REPLACE subcommand 187 

example of 188 

with DBCS strings 432 
replacing characters 

using COVERLAY 53 

using CREPLACE 56 
replacing current line 187 
reserved line 

displaying data on 279 

displaying the number of 280 

returning to the editor 280 

transferring the number of 280 
RESERVED option 

of EXTRACT 83 

of QUERY 168 

of SET 279 

of TRANSFER 354 
reserving a line 279 
RESET subcommand 189 

example of 189 
respecting case difference 213 
RESTORE subcommand 190 
restoring the screen 

after LEFT 114 

after RIGHT 193 
restoring variables 190 

restrictions imposed by the VM/Passthru Facility 238 
retrieving deleted hues 180 
retrieving lines 

saved by PUT 101 

saved by PUTD 101 
returning from CMS subset mode 42 
returning from CP 55 
RGTLEFT subcommand 191 
right shift 330 
RIGHT subcommand 193 

example of 195 
ring of files 287, 364 
RING option 

of EXTRACT 83 

of QUERY 169 
RTARGET option of ALL 1 6 
rules for entering subcommands 1 

S 

S prefix macro 388 
SAVE subcommand 196 
saving a file 

using FILE 92 

using SAVE 196 

using SET AUTOS AVE 210 
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saving variables 1 54 
scale 

displaying 

using SCALE (prefix subcommand) 389 
using SET SCALE 282 

displaying when defining mask 250 

illustration of 282 

removing firom screen 282 
SCALE option 

of EXTRACT 84 

of QUERY 169 

of SET 282 

of TRANSFER 354 
SCALE prefix subcommand 389 
scanning a file 123 
SCHANGE macro 200 

assigned to a PF key 200 

used with AUTOSAVE ON 201 
SCOPE option 

of EXTRACT 84 

of QUERY 169 

of SET 284 
screen changes stacked by READ 176 
screen display, updating 182 
screen divided into multiple logical screens 286 
screen layout 

in input mode 108 

in power typing mode 152 
screen operation simulation 339 
SCREEN option 

of EXTRACT 84 

of QUERY 169 

of SET 286 

of TRANSFER 355 
screen scrolling 

backward 22 

forward 100 
screen, reserving a line on 279 
screen, virtual 441 
scrolling 

backward 22 

forward 100 
search direction, specifying 

for column-target 39 

for target 124 
search order for subcommands and macros 

controlling 249 
searching a file 123 
SELECT opfion 

of EXTRACT 84 

of QUERY 170 
selective change 200 
selective Hne editing 405 

See also ALL macro 

example of 408 

subcommands 405 
sequence of commands assigned to a PF key 269 



SEQ8 option 

of EXTRACT 84 

of QUERY 170 

of TRANSFER 355 
serial identification 

removing 300 

specifying 299 
SERIAL option 

of EXTRACT 84 

of QUERY 170 

of SET 299 

of TRANSFER 355 
serialization of file, controlling 299 
SET ALT 204 
SET APL 206 
SET ARBCHAR 207 

use in CHANGE 32 

used with COUNT 51 
SET AUTOSAVE 210 
SET BRKKEY 212 

changing the CP setting 212 

default setting 212 
SET CASE 213 

with DECS strings 430 
SET CMDLINE 215 
SET COLOR 217 
SET COLPTR 220 
SET CTLCHAR 221 
SET CURLINE 224 

used to change size of input zone 109 
SET DISPLAY 226 
SET ENTER 228 
SET ESCAPE 230 

use in input mode 109 
SET ETARBCH 231 

with DECS strings 431 
SETETMODE 233 
SET FILLER 234 
SET FMODE 235 
SET FNAME 236 
SET FTYPE 237 
SET FULLREAD 238 
SET HEX 240 
SET IMAGE 241 

list of subcommands affected by 242 
SET IMPCMSCP 243 
SET LASTLORC 244 
SET LINEND 245 
SET LRECL 247 

with DECS strings 433 
SET MACRO 249 
SET MASK 250 

example of 251 
SET MSGLINE 253 

with FULLSCREEN OFF 253 

with FULLSCREEN ON 253 
SET MSGMODE 255 
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SETNONDISP 257 
SET NULLS 259 
SET NUMBER 260 
SET options 

displaying current values of 
using QUERY 162 
using STATUS 348 

modifying 137 

querying 162 

transferring 351 
SET OUTPUT, issuing while in XEDIT 257 
SET PACK 263 
SET PAn 261 
SET PENDING 265 

example of 267 
SET PFn 268 
SET POINT 271 
SET PREFIX 273 
SET RANGE 275 
SET RECFM 277 
SET REMOTE 278 
SET RESERVED 279 
SET SCALE 282 
SET SCOPE 284 
SET SCREEN 286 

with FULLSCREEN OFF 287 

with FULLSCREEN ON 287 
SET SELECT 290 
SET SERIAL 299 

with DBCS strings 433 
SET SHADOW 301 
SET SIDCODE 303 

with DBCS strings 433 
SET SPAN 304 

with DBCS strings 431 
SET SPILL 306 

example of 307 

with DBCS strings 433 
SET STAY 308 

use in CHANGE 32 
SET STREAM 309 

effect in CDELETE 27 

used with column target 40 
SET subcommand 
SET SYNONYM 310 

example of 312 

with DBCS strings 433 
SETTABLINE 313 
SET TABS 315 

used by EXPAND 68 

using with compress and expand 46 
SET TERMINAL 317 
SET TEXT 318 
SETTOFEOF 319 
SET TRANSLAT 320 
SET TRUNC 322 

use in CHANGE 32 

with DBCS strings 434 



SETVARBLANK 323 

with DBCS strings 431 
SET VERIFY 324 

hexadecimal data, entering 324 

with DBCS strings 435 
SET WRAP 326 
SET ZONE 327 

use in CHANGE 32 

with DBCS strings 436 
SET = 329 
SHADOW option 

of EXTRACT 84 

of QUERY 170 

of SET 301 
SHIFT subcommand 330 

with DBCS strings 437 
shift-in (SI) character 419 
shift-out (SO) character 419 
shifting data 

using SHIFT 330 

using < prefix macro 397 

using > prefix macro 400 
show excluded lines 388 
SI macro 332 

example of 333 
SI prefix macro 390 
SIDCODE option 

of EXTRACT 84 

of QUERY 170 

of SET 303 

of TRANSFER 355 
size of logical screen defined 286 
SIZE option 

of EXTRACT 85 

of QUERY 170 

of TRANSFER 355 
sizing a virtual screen 441 
sizing a window 441 
SORT macro 337 

example of 338 
sorting 337 
SOS option 

ALARM 339 

CLEAR 339 

LINEADD 339 

LINEDEL 339 

NULLS 339 

PFn 339 

POP 339 

PUSH 339 

TABB 340 

TABCMD 340 

TABCMDB 340 

TABCMDF 340 

TABF 340 
SOS subcommand 339 
sounding the alarm 66 
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span lines, allowing string target to 304 
SPAN option 

of EXTRACT 85 

of QUERY 170 

of SET 304 

of TRANSFER 355 
SPILL option 

of EXTRACT 85 

of QUERY 170 

of SET 306 
split a line 

at column number(s) 341 

at column pointer 341 

at cursor 341 

at string 341 
SPLIT macro 

example of 343 

with DECS strings 437 
SPLTJOIN macro 344 
SPLTJOIN subcommand 

with DECS strings 438 
spool to copy screen to printer 268 
SSAVE subcommand 196 
STACK subcommand 346 
stacking lines 346 
status area 

during macro execution 179 

during prefix subcommands 373 

im multiple logical screens 286 

resetting 1 89 
status area message 

C or 'CC pending... 377 

'D' or 'DD' pending... 379 

T' pending... 382 

'P' pending... 387 

'XX' pending... 394 

' ' pending... 332, 390 

' < < ' pending... 397 

'> >' pending... 400 

""" pending... 402 
STATUS macro 348 
STAY option 

of EXTRACT 85 

of QUERY 170 

of SET 308 

of TRANSFER 355 
STREAM option 

of EXTRACT 85 

of QUERY 170 

of SET 309 

of TRANSFER 355 
string expression 

example of specifying target as 125 

examples of specifying column- target as 39 

format of 39, 124 

specifying column-target as 39 

specifying target as 124 



structured input 332, 390 
subcommands 

assigning to PF key 268 

controlling search order for 249 

entering in input mode 

multiple 

assigned to PF key 269 
entered on command line 245 

redisplaying 
using ? 370 

reexecuting 369 

using & 368 
summary 

of prefix subcommands 452 
summary of XEDIT subcommands and macros 447 
symbolic name 

assigning 

usinf SET POINT 271 

using .xxxx (prefix subcommand) 396 

displaying 168, 271 

transferring 354 
synonym 

abbreviation of 
specifying 310 

controlling search for 310 

defining for prefix subcommand 273 

defining for subcommand 310 

rearranging operands of 311 
synonym check, overriding with COMMAND 45 
SYNONYM option 

of EXTRACT 85 

of QUERY 170 

of SET 310 

of TRANSFER 355 

T 

tab characters 

affected by SET IMAGE 241 

how handled by FIND 96 

how handled by FINDUP 98 

how handled by NFIND 144 

how handled by NFINDUP 146 

in input line 108 

inserted by compress 46 
tab line 

displaying 

using SET TABLINE 313 
using TAEL (prefix subcommand) 393 
tab settings 

defining 315 

used by EXPAND 68 
TAEKEY option 

of SET PAn 261 

of SET PFn 268 
TAEL prefix subcommand 393 
TABLINE option 

of EXTRACT 86 
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207 
124, 240 



TABLINE option (continued) 
of QUERY 171 
of SET 313 
of TRANSFER 355 
TABS option 

of EXTRACT 86 
of QUERY 171 
of SET 315 
of TRANSFER 355 
target 

affected by SET IMAGE 241 

as absolute line number 123 

as complex string expression 124 

as line name 124 

as relative displacement 123 

as string expression 124 

description of 123 

ignoring characters within 

specifying in hexadecimal 

UPPERCAS 362 

in ALTER 20 

in CHANGE 31 

in COMPRESS 46 

in COPY 49 

in COUNT 51 

in DELETE 61 

in DUPLICAT 65 

in EXPAND 68 

in HEXTYPE 106 

in LOCATE 123 

in LOWERCAS 128 

in MOVE 139 

in PUT 156 

in PUTD 159 

in SET RANGE 

in SHIFT 330 

in SORT 337 

in STACK 346 

in TYPE 358 
use with DECS strings 
TARGET option 
of EXTRACT 86 
of QUERY 171 
of TRANSFER 355 
target search 

defining columns for 
ignoring case in 213 
respecting case in 213 
with DECS strings 420 
task menus 104 
task menus, RELATED 
TASK option of HELP 
task-oriented help files 
TERMINAL option 
of EXTRACT 87 
of QUERY 171 
of SET 317 
of TRANSFER 355 



use 
use 
use 
use 
use 
use 
use 
use 
use 
use 
use 
use 
use 
use 
use 
use 
use 
use 
use 



275 



420 



327 



104 
104 
104 



terminal, display 

used in full screen mode 317 

used in line mode 317 
terminating editing session 

using CANCEL 24 

using FILE 92 

using QUIT 174 
TEXT keys 

allowing the use of 318 
TEXT option 

of EXTRACT 87 

of QUERY 171 

of SET 318 

of TRANSFER 355 
TOF option 

of EXTRACT 87 

of QUERY 171 

of TRANSFER 356 
TOFEOF option 

of EXTRACT 87 

of QUERY 171 

of SET 319 

of TRANSFER 356 
TOL option 

of EXTRACT 87 

of QUERY 171 
Top of File line, controUing display of 319 
top of file, moving Une pointer toward 

using target 124 

using UP 360 
top of range 275 

Top of Range line, controlling display of 319 
TOP subcommand 350 
TRANSFER subcommand 351 
transferring data between files 

using GET 101 

using PUT 156 

using PUTD 159 
transferring setting of editing options 351 
TRANSLAT option 

of EXTRACT 87 

of QUERY 171 

of SET 320 
translating characters 

to lowercase 128 

to uppercase 362 
transmitting commands 

to CMS 42 

to CMS/CP automatically 243 

to CP 55 
TRUNC option 

of EXTRACT 87 

of QUERY 172 

of SET 322 

of TRANSFER 356 
truncation column, defining 322 
TYPE subcommand 358 
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typewriter terminal 

controlling display of column pointer on 220 
using escape character on 230 
using input mode 109 

u 

underscore 

used in COVERLAY 53 

used in FIND 96 

used in FINDUP 98 

used in NFIND 144 

used in NFINDUP 146 

used in OVERLAY 148 
UNIQUEID option 

of EXTRACT 87 

of QUERY 172 
unprotected QUIT 24 
UNTIL option 

of EXTRACT 88 

of QUERY 172 
UP subcommand 360 

example of 361 
update mode 7, 364 
UPDATE option 

in XEDIT 7 

of EXTRACT 88 

of QUERY 172 

of TRANSFER 356 
updating screen display 182 
UPPERCAS subcommand 362 

example of 363 

with DBCS strings 438 
uppercase 

translating characters entered into 213 

translating characters in file to 362 



VARBLANK option 

of EXTRACT 88 

of QUERY 172 

of SET 323 

of TRANSFER 356 
variable number of blanks, significance of 323 
variable packed record format 277 
variable record format 277 
variables 

not restored by RESTORE 190 

not saved by PRESERVE 154 

restored by RESTORE 190 

saved by PRESERVE 154 
verification of changed Hnes 33 
VERIFY option 

of EXTRACT 88 

of QUERY 172 

of SET 324 

of TRANSFER 356 



VERSHIFT option 

of EXTRACT 88 

of QUERY 172 

of TRANSFER 356 
viewing data 

examples 116 

to the left 114 

to the right 193 
Virtual Screen 

defining 441 

general description 441 

naming 441 

sizing 441 
VMFDEOPT macro 417 
VMFOPT macro 416 

VM/Passthru Facihty, restrictions imposed by 238 
VSBASIC file, renumbering 183 

w 

warning message issued by QUIT 175 
WIDTH option 

of EXTRACT 88 

of QUERY 172 

of TRANSFER 356 

of XEDIT 6 
WINDOW 

defining 441 

general description 441 

naming 441 

sizing 441 
WINDOW opfion 

of EXTRACT 88 

of LOAD 117 

of XEDIT 6 
wrap around 326 
WRAP option 

of EXTRACT 88 

of QUERY 172 

of SET 326 

of TRANSFER 356 
wrapping, automatic Hne 325 
writing file on disk 

using FILE 92 

using SAVE 196 

using SET AUTOSAVE 210 



X prefix macro 394 
XEDIT command 5 

relation to LOAD 117 
XEDIT macro name 133 
XEDIT subcommand 364 
XEDIT subcommands and macros summary 447 
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zone 

defining 327 

effect on CFIRST 327 

effect on CHANGE 327 

effect on CLAST 327 

moving column pointer to beginning of 30 

moving column pointer to end of 37 
ZONE option 

of EXTRACT 89 

of QUERY 172 

of SET 327 

of TRANSFER 356 

Special Characters 

.xxxx prefix subcommand 396 

< prefix macro 397 

I used in string targets 124 

& subcommand 368 

& used in string targets 124 

$ (as default arbitrary character) 207 

/ prefix subcommand 399 

> prefix macro 400 

? subcommand 370 

# (as default line-end character) 245 

= option 

of EXTRACT 89 

of QUERY 172 

of SET 329 

of TRANSFER 356 
= subcommand 369 
" prefix subcommand 402 
'C or 'CC pending... 377 
'D' or 'DD' pending... 379 
'F' pending... 382 
'P' pending... 387 
'XX' pending... 394 
' ' pending... 332, 390 

example of 391 
'< <' pending... 397 
'> >' pending... 400 
"""pending... 402 
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